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PREFACE 



This publication contains detailed information necessary to implement 
three IBM program products: CICS/DOS-ENTRY, CICS/DOS-STANDARD, and 
CICS/OS-STANDARD V2 . It provides system programmers, system analysts, 
and system administrators with information that is primarily independent 
of the operating system involved; for example, the use of CICS macro 
instructions to selectively generate CICS management programs and 
service programs and selectively prepare system control tables and 
service tables. It is assumed that the reader of this publication has 
some knowledge and/or experience concerning the Basic Telecommunications 
Access Method (BTAM) or has access to persons with such knowledge 
and/or experience. 

This publication should be used in conjunction with the appropriate 
CICS Operations Guide when generating CICS and when preparing the 
system tables that describe the environment CICS is to support. 

Throughout this publication, parentheses are used in the notation 
of CICS macro instructions to indicate those operands where more than 
one applicable parameter can be specified with a single use of the 
operand. Where parentheses are not used, only one parameter at a time 
can be specified as part of the operand. An asterisk in (card) column 
72 indicates that the macro instruction is continued on the next line 
(card) . The first operand on a continuation card must begin in column 
16. 

The words "transaction" and "task" have the same connotation in 
CICS and are used interchangeably throughout this publication; the 
processing of a transaction may involve the execution of one or more 
"programs" . 

For further information concerning CICS, see the following IBM 
publications : 

General Information Manual (GH20-1028) 

Application Programmer's Reference Manual (SH20-1047) 

Terminal Operator's Guide (SH20-1044) 

Operations Guide (CICS/DOS) (SH20-103U) 

Operations Guide (CICS/OS) (SH20-1048) 

Logic Manual (CICS/DOS-ENTRY) (LY20-0712) 

Logic Manual (CICS/DOS-STANDARD) (LY20-0713) 

Logic Manual (CICS/OS-STANDARD V2) (LY20-0714) 

All references to CICS/OS and CICS/OS-STANDARD in this publication 
are references to the CICS/OS-STANDARD V2 system. 

Note : Information in this publication concerning TCAM is applicable 

only to the CICS/OS system. Information concerning 3735 support 
is not applicable to CICS/DOS-ENTRY. 
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INTRODUCTION 



The IBM Customer Information Control System (CICS) is a 
multi-application data base/data communication interface between OS or 
DOS and user-written application programs. Applicable to most online 
systems, CICS provides many of the facilities for standard terminal 
applications: message switching, inguiry, data collection, order entry, 
and conversational data entry. 

Functions performed by CICS include: 

• Control of a mixed telecommunications network 

• Concurrent management of a variety of programs 

• Controlled access to the data base 

• Management of resources for continuous operation 

• Prioritization of processing 

By eliminating many of the development reguirements for such 
functions of a real-time control system, CICS allows programmers to 
concentrate instead on implementing applications, dramatically reducing 
implementation time and cost. 

Functions needed to support a data base/data communication system 
and standard terminal applications are provided by the following CICS 
management programs: 

o Task Management - Provides its own dynamic multitasking facilities 
necessary for effective, concurrent transaction processing. 
Functions associated with this facility include priority scheduling, 
transaction synchronization, and control of serially reusable 
resources. This CICS facility is in addition to the multitasking 
or multiprocessing facilities of the host operating system. 

• Storage Management - Controls main storage allocated to CICS. 
Storage acguisition, disposition, initialization, and reguest 
gueuing are among the services and functions performed by this 
component of CICS. 

• Program Management - Provides a multiprogramming capability through 
dynamic program management while offering a real-time program fetch 
capability. 

• Program Interrupt Management - Provides for the interception of 
program interrupts by CICS to prevent total system termination. 
Individual transactions that program check are terminated by CICS 
with a dump (if Dump Management is used) , thus preventing the entire 
CICS partition/region from terminating. Under CICS/OS, supports 
the runaway task control function of CICS Time Management. 

• Time Management - Provides control of various optional task 
functions (system stall detection, runaway task control, task 
synchronization, etc.) based on specified intervals of time or the 
time of day. 

• Dump Management - Provides a facility to assist in analysis of 
programs and transactions undergoing development or modification. 
Specified areas of main storage are dumped onto a seguential data 
set, either tape or disk, for subseguent offline formatting and 
printing using a CICS utility program. 



• Terminal Management - Provides polling according to user-specified 
line traffic control as well as user requested reading and writing. 
This facility supports automatic task initiation to process new 
transactions. Optionally, the user can reguest that certain lines 
be under control of TCAM (rather than BTAM) in which case polling 
and other network control functions are performed by the Message 
Control program (MCP) residing in another partition/region. The 
testing of application programs is accommodated by the simulation 
of terminals through sequential devices such as card readers, line 
printers, disk, tape, etc. 

• File Management - Provides a data base facility using direct access 
and indexed sequential data management. This function supports 
updates, additions, random retrieval, and selective retrieval 
(browsing) of logical data on the data base. Optional access to 
the Data Language/I (DL/I) facility of the IBM Information 
Management System (IMS/360) is also provided under CICS/OS. Use 

of DL/I requires the installation of the IMS/360 Version 2, 
Modification Level 2 (or later) Data Base System (5734-XX6) . 

• Transient Data Management - Provides the optional gueuing facility 
for the' management of data in transit to and from user-defined 
destinations. This function facilitates message switching, data 
collection, and logging. 

• Temporary Storage Management - Provides the optional general purpose 
"scratch pad" facility. This facility is intended for video display 
paging, broadcasting, data collection suspension, conservation of 
main storage, retention of control information, etc. 

In addition to these management functions, CICS provides system 
service programming to identify terminal operators, to give dynamic 
control of the entire system to a master terminal, to display real-time 
system statistics, to intercept abnormal conditions not handled directly 
by the operating system, and to end operation by gathering summary 
statistics, closing data sets, and returning control to the operating 
system. 



GENERAL DESCRIPTION 



THE REAL-TIME SYSTEM MIIS2IIM1I1 

The real-time data base/data communications (DB/DC) environment is 
characterized by a number of factors which distinguish it from the 
conventional batch processing environment. For example, the system 
programmer must be aware of considerations inherent to the real-time 
system environment, such as: 

• Transactions are not batched by type, but arrive randomly. 

• Online data storage is expensive, so that storing redundant subsets 
of data is an undesirable approach to providing the data access 
required by other applications and programs. 

• Sorting and scanning data prohibits the rapid access needed by a 
single transaction. 

• A number of transactions can simultaneously try to change the same 
data. 

• A terminal user may attempt an unauthorized access of confidential 
data. 

• A (software) recovery capability is required to prevent data losses. 

REAL-TIME SYSTEM PROGRAMMING 

The real-time data base/data communications environment (DB/DC) 
differs from the traditional batch processing environment primarily in 
the amount and types of concurrent activities that are likely to occur 
within the system at a given time. Whereas a batch processing system 
schedules each application independently and provides data support 
unique to each application, a DB/DC system controls many transactions 
arriving on a random nonscheduled basis and provides a data base (with 
integrated data) supporting each application. 

In the conventional batch processing environment, the application 
programmer plans a series of runs to edit batches of input transactions, 
update master files, and write output reports. To optimize total run 
time and streamline the cycle, he must concentrate on careful 
manipulation of data. In accomplishing this, the data becomes 
intricately tied to his program logic and is of little value in other 
applications. 

CICS solves many of these complexities by managing data centrally 
in a data base on behalf of all applications. This relieves the 
application programmer of system management considerations, allowing 
him to concentrate instead on the application, and shifts the 
responsibility for an integrated data base to the system programmer. 

As an effective interface, the system programmer must organize all 
the data and optimize its storage, making tradeoffs between cost of 
storage, performance, and service level according to management 
guidelines. The DB/DC system has a common data set (data base) manager, 
and usually provides the system programmer with specialized interfaces. 



PREPARING THE SY STEM 

CICS is modularly designed to allow the user to configure a data 
base/data communications system appropriate to his needs. While some 
of the system components are essential, many are optional and can be 
configured into the system under user control. 

CICS modularity allows the user to: 

1. Include or omit functions or components. 

2. Replace or extend a function or component. 

3. Evolve and expand the support of the user's environment. 

4. Conduct maintenance on a component level. 

5. Bring the most current individual components together at 
execution time to support the desired environment. 

To assist the user in tailoring the system to meet his needs, source 
code is distributed to the user which must be assembled to provide the 
specific functions and components the user desires. The detailed 
instructions in preparing the system from the distributed 
machine-readable material is contained in the appropriate CICS 
Operations Guide. 

SYSTEM GENERATION 

CICS provides a system generation facility whereby the user can 
define what CICS-provided functions or components he desires as well 
as certain variables he wants included. The system is then generated 
according to that description. 

CICS provides ten executable management programs which can be 
selected and generated by the user to perform the following functions: 

1. Task Management 

2. Storage Management 

3. Program Management 

4. Program Interrupt Management 

5. Time Management (Interval Control) 

6. Dump Management 

7. Terminal Management 

8. File Management 

9. Transient Data Management 
10. Temporary Storage Management 

In addition to the managment programs, a number of system service 
programs (which run as application programs) can be generated. The 
service functions which these programs provide are: 

1 . Sign on/sign off 

2. Master terminal 

3. Supervisor terminal 

4. Operator terminal 

5. System statistics 

6. Abnormal condition handling 

7. Terminal abnormal condition handling 

8. Asynchronous Transaction Processing 

9. System termination 

10. Terminal test 

11. Time of day control 

Two utility programs can also be generated. These are the Dump 
Utility program for formatting and printing the dumps (produced during 
execution) , and the High-Level Language Preprocessor which is used to 
prepare the ANS COBOL and PL/I application programs for execution under 



CICS. In the CICS/DOS systems, a special linkage-editor facility is 
also generated for use in preparing the object modules for execution. 

An optional user-defined Common Work Area (CWA) is provided as an 
extension of the Common System Area (CSA) in static main storage. This 
work area is available for the use of all user-written programs and 
can be used to contain user-defined data (which is not to be altered 
by CICS) such as tables, accumulators, and sequence numbers. The length 
of the CWA must be specified during system generation. 

The details concerning how to use the DFHSG macro instruction to 
generate the system are provided in the System Generation section of 
this manual. The necessary JCL is detailed in the appropriate CICS 
Operations Guide. 

SYSTEM TABLE PREPARATION 

CICS is table-oriented. This feature gives the user flexibility in 
describing his terminal, data base, and queuing environments. It allows 
him to describe several versions of existing environments, simplifying 
evolution and growth to new environments. Because of the table 
orientation, the user need change only that part of his environment 
that needs to be changed. 

All tables are specified and constructed by the user with assistance 
provided by CICS. These tables are declarative in nature and are used 
by CICS to control the environment according to the design criteria 
established by the user. Major tables are used to describe System 
Initialization and terminal, data set, and queuing environments. Other 
tables identify user programs, transactions, operators, etc. 

Detailed information on the contents of these tables and the macro 
instruction used to prepare them are provided in the section "System 
Table Preparation". 

The Process Control Information field (PCI) is an optional 
user-defined terminal work area which is provided as an extension of 
the Terminal Control Table (TCT) in static main storage. The PCI is 
associated with a particular TCT terminal entry (TCTTE) and is available 
for the use of all user-written programs that are logically attached 
to that TCTTE. The PCI can be used to contain user-defined data (which 
is not to be altered by CICS) such as user statistics and sequence 
numbers. 

The PCI is a variable-length field (0-255 bytes) which is specified 
during system generation. For CICS/OS, PCI's of fixed length (15 bytes) 
may also be specified during system generation for the purpose of upward 
compatiblity from CICS/OS-STANDARD V1 to CICS/OS-STANDARD V2. The 
length of the PCI is specified during preparation of the TCT. 

S.YSTEM MAINTENANCE 

Because CICS is both modular and table-oriented, maintenance is 
simplified considerably. If a change in the user's environment should 
occur which, in turn, requires a change to a CICS management program 
and/or table, only the affected program or table needs to be generated 
again. This, of course, is also true of any corrections that must be 
applied to the system. To make a correction to a particular program 
only the source code for that program needs to be updated, using the 
appropriate operating system update facility, and then reassembled and 
link edited. 



SYSTEM DATA SET CONSIDERATIONS 

The access methods and record content of the system data sets are 
predefined within CICS. Any required formatting is performed by CICS 
during system initialization or by the maintenance functions. For 
space considerations and requirements, see the appropriate CICS 
Operations Guide. 

The system data sets (files) include: 

• Real-Time Relocatable Program Library 

• Real-time Pre-Located Program Library 

• Transaction Rollout Data Set 

• Dump Data Set 

• Intrapartition Data Set 

• Temporary Storage Data Set 

Re al-T ime Relocatable Program Library 

The Real-Time Relocatable Program Library contains all user programs 
and CICS programs to be loaded and executed in real-time including the 
control system itself and certain user-prepared System Control Tables. 
The library contains program text and, where applicable, a relocation 
dictionary for each program. The contents of this library are 
asynchronously fetched into main storage for real-time execution in 
the CICS/DOS-STANDARD and CICS/OS-STANDARD systems by the Program 
Control Program. This library is not used for real-time execution in 
the CICS/DOS-ENTRY system. 

For the CICS/DOS-STANDARD system, the Real-Time Relocatable Program 
Library is a user allocated extent. Programs are prepared for this 
library by DFHLINK. For the CICS/OS-STANDARD system, the Real-Time 
Relocatable Program Library is a standard partitioned data set. 
Programs are prepared for this library by the OS Linkage Editor. 
CICS/OS users may concatenate other private libraries to this library. 

Real-Time Pre-Loc ate d Program Libra ry 

The CICS Real-Time Pre-Located Program Library is used in the 
CICS/DOS-ENTRY system to retain the nonresident application programs 
during real-time execution. All application programs, so designated 
by the user, are loaded into main storage by the CICS System 
Initialization program and are written into the library for subsequent 
fetch and refresh. The Processing Program Table in main storage serves 
as the directory for this library. 

Tr ans action Roll out Data Set 

The Transaction Rollout data set (file) is used in the CICS/DOS-ENTRY 
system to retain certain transaction information in order to support 
conversational interaction with a terminal. The types of transaction 
information that may be expected to be rolled into this data set 
include: 

1. Task Control Area 

2. Transaction Work Area 

3. User-acquired work areas 

4. File, Temporary Storage, Transient Data input/output areas, 
work areas, and control areas 

5. Register storage areas 

6. Loaded programs 



Dump Data Set 

The optional dump data set is used by the Dump Control program to 
record dumps of transactions within the system. It is a sequential 
data set located on either magnetic tape or direct access and can be 
subsequently formatted and printed by the CICS Dump Utility program. 

CICS provides the capability to open/close the active dump data set 
during the real-time "execution of the system. Optionally, the user 
can define two dump data sets (DIHDMPA and DFHDMPB) , alternating between 
them during real-time execution of CICS. 

Intr apart it ion Data Set 

The Intrapartition data set is a system option and is used for the 
gueuing of user data and, optionally, CICS data by the Transient Data 
Control program (CICS's general purpose queuing facility). Data, as 
reguested, is stored chronologically into this data set according to 
previously identified symbolic destinations for subsequent retrieval 
when all applicable system conditions and facilities are in the 
appropriate status. This data set is reusable and is required for 
applications such as message switching, broadcasting, order 
distribution, etc. The record format for this data set is standard 
System/360 variable length. 

Temporary Storage Data Set 

The Temporary Storage data set is a system option, and should be 
allocated, if required, by the user as general purpose scratch pad 
storage for use by the Temporary Storage Control program. User data, 
as requested, is stored into this data set under a dynamically-provided 
symbolic identification for subsequent retrieval and release (when 
appropriate) . This data set is intended for applications such as 
broadcasting, video display paging, transaction suspension, main storage 
conservation, etc. This data set consists of variable-length records 
within a preformatted fixed-length DAM data set record and is required 
if the "time ordered" automatic task initiation feature of CICS is 
generated. Any task* which reguests the use cf Temporary Storage when 
space is not available will be suspended until adequate space is freed 
ty another task. 

USER DATA BASE CONSIDERATIONS 

CICS File Management allows the user a high degree of flexibility 
when defining the structure of his data base. Individual data sets 
(files) within the data base can be accessed under control of the Direct 
Access Method (DAM) or the Indexed Sequential Access Method (ISAM) . 
The following optional CICS features allow certain variations in data 
organization to provide the user with the most efficient data base 
structure suitable to his environment. 

Segmented Records 

CICS stores data in and retrieves data from the user's data sets. 
It is possible to retrieve an individual record or selected segments 
of an individual record. A segmented record is one in which the 
components of the record have been identified and grouped according to 
frequency of use, function, and logical relationship. The identifiable 
groups are called segments. Some segments are in all records, such as 
those that contain identification or major record control fields. Other 
segments apply only in certain records. The primary reason for 



segmenting records is to conserve main storage, or, in the case of 
variable-length records, to conserve direct access storage. 

If additional information is to be included in a segmented record, 
either a new segment is created or an existing segment is altered. In 
either case, only the affected segment descriptions need be changed 
and the new programming added to support the change. Symbolic 
references to unchanged segments are not affected. Adding information 
to a fixed format record cculd reguire considerably more programming 
than using the segmented record approach. 

The user must define the record segments to CICS. In addition, each 
record to be retrieved in segments must have control information in 
the first segment which is used to indicate the presence or absence of 
each segment. A segment should contain logically related data so that 
only selected segments are reguired to satisfy the processing 
requirements of a transaction. A transaction that uses only selected 
record segments requires less main storage for its processing. 

The user, in selecting those segments necessary for processing 
transaction groups, identifies them to CICS as a part of the data set 
(file) definitions in the File Control Table. Such a group of segments 
is a segment set. A segment set can include a single segment, a number 
of segments, or all segments of a record. When a request is made to 
File Control identifying a segment set in the request, CICS always 
returns the header control segment plus the segments in that set. 

Segmented records can be used with either DAM or ISAM data set 
organizations. For further details concerning segmented records, see 
"Data Base Considerations" in the CICS Application Programmer 'g 
Reference Manual (SH20-1047) . 

Pjg^lockinq Services for DAM Data Sets 

CICS provides deblocking of logical records which are blocked and 
written on a direct access (DAM) data set. This service is provided 
for both fixed- and variable-length records. The data set must be 
created according to standard System/360 record formatting conventions. 

Indexed Data Sets - Indirect Accessing 

CICS (optionally) allows the use of cross-index data sets to access 
another data set which may be the main data set or another level of 
index data set. If a record retrieved from a cross-index data set 
indicates multiple entries in the main data set, information is returned 
to the user-written application programs to be used in selecting the 
appropriate main data set entry. When the cross index does not indicate 
multiple entries in the main data set, the File Control program reads 
the reguested record from the main data set. 

Organization of the cross-index data set may be either indexed 
seguential or basic direct access. The index record contains, in 
addition to the information used to find it, the search argument for 
the record on the data set which the index data set references. The 
index record may contain any other information desired by the user. 
The location of the search argument, its length, and the data set 
identification for the referenced data set are supplied to CICS as part 
of the data set definitions in the File Control Table. For further 
details concerning indirect accessing, see "Data Base Considerations" 
in the CICS Application Programmer's Reference Manual (SH20-1047) . 



DOS ISA M Variable- Length Re cord s 

The CICS/DOS systems support the retrieval and static update (no 
length variation) of variable-length logical records within fixed-length 
blocks under an ISAM organization. These pseudo-variable blocks must 
conform to System 360/370 variable-length record format conventions. 
That is, the first four bytes must contain the block length of the form 
LLbb. Since all blocks are fixed length, this value will be the same 
for all blocks. Each logical record within the block must reflect the 
length of the record in the first four bytes (LLbb) . A logical record 
may not be continued onto the next block. The first byte of any unused 
portion of a block must contain a hexadecimal FF. 

The addition and deletion of records on a DOS ISAM variable-length 
record data set must be handled by the user in an offline batch 
environment. When creating the data set, it must be defined as fixed 
unblocked, and the key for each block must be the same as the last 
logical record in that block. The block size must be an even number 
of bytes. All records must reside in the prime data area; no overflow 
records are allowed. For details concerning the CICS definition of a 
DOS ISAM variable- length record data set, see the discussion of the 
File Control Table in the section "System Table Preparation". 

Data Language/I Data Sets 

Optional access to the Data Language/I (DL/I) facility of the IBM 
Information Management System (IMS/360) requires the installation of 
the IMS/360 Version 2, Modification Level 2 (or later) Data Base System 
(5734-XX6) . 

As CICS is initialized, an IMS batch job is attached (via OS) as an 
OS subtask of CICS in much the same fashion as a regular IMS system is 
executed as an OS job. All data sets required for a batch IMS job are 
required for access to DL/I under CICS. 

USER EXTRAPARTITION DATA SETS 

Extrapartition data is the name given in CICS to transient stream 
data which is coming into or going out of the data base/data 
communication system environment. This data is usually coming from or 
going to high-speed magnetic devices and is characterized by, but not 
required to be, blocked, variable-length stream data. The 
extrapartition disposition facility is intended for use with the 
following types of data and applications: 

1. Message logging 

2. Transaction logging 

3. Reconstruction records and information 

4. Data collection 

5. Data entry 

and all other output stream data intended for subsequent processing 
(usually offline) . The user defines this data consistent with his 
requirements and facilities. The extrapartition acquisition facility 
is intended for limited stream (batch- like) data processing in the data 
base/data communication environment. 



USER EXITS 

Exit routines may be provided by the user to extend or add functions 
to CICS management programs. All CICS management program exits are 
included at the source level and are assembled with the management 
program during system generation. The user exits provided for are as 
follows: 



CICS MANAGEMENT PROGRAM 
Task Control (DFHKCP) 

Storage Control (DFHSCP) 
Program Control (DFHPCP) 
Interval Control (DFHICP) 

Terminal Control (DFHTCP) 
File Control (DFHFCP) 



Transient Data Control 
(DFHTDP) 



Temporary Storage Control 
(DFHTSP) 



USER EXIT 

Before reguest analysis 
Before task dispatch 

Before reguest analysis 

After program load 

Before reguest analysis 

At expiration of time interval 

Before transaction attach 
Before output event initiation 
After input event completion 

Before service reguest analysis 
Before output event initiation 
Before input event initiation 
After input event completion 

Before service reguest analysis 
Before output event initiation 
After input event completion 

Before service reguest analysis 
Before output event initiation 
After input event completion 



For further information concerning user exits, see the discussion 
of the individual CICS management programs in the section "System 
Generation"; see also the section "Creating User Exits for CICS 
Management Programs". 

EXECUTING THE SYSTEM 

CICS is designed to bring together at execution time the most current 
individual components to support the environment reguirements present 
at that time. Through the use of the appropriate System Initialization 
Table and the necessary overrides, any combination of CICS management 
programs and tables may be loaded and executed. Thus, the user may 
have a test module and a standard module of any of the various CICS 
management programs and tables (only one of which may be in main storage 
for a given execution) . He can then execute CICS using the test module; 
if it doesn't work satisfactorily, he can execute CICS again using the 
standard module that he knows is working. 

JOB CONTROL 

The job control language (JCL) statements needed to execute CICS 
varies not only with the operating system environment desired but also 
with the choice of CICS functions and types of data organization. 
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Specific examples of JCL can be found in the appropriate CICS Operations 
Guide. 

In a CICS/OS environment, a procedure may be set up so that execution 
of a "standard" system requires a minimal amount of JCL to be submitted 
as a job. Only for execution of a test system or for other than the 
defined standard system would a larger JCL deck be necessary. 

In a CICS/DOS environment, the user can elect to use Single Program 
Initiate (SPI) to activate CICS with a minimal amount of JCL. 

SYSTEM INITIALIZATION 

The flexibility in specifying which CICS management programs and 
tables are to be loaded for a particular execution is accomplished 
through the System Initialization program (DFHSIP) . This program is 
named on the EXEC card in the JCL and is used to accomplish the 
following: 

1 . Load the specified System Initialization Table. 

2. Request any overrides that are desired. 

3. Load the requested CICS management programs and tables. 

4. Initialize tables and areas. 

5. Open all required data sets. 

6. Load any resident application programs. 

7. Pass control to the Terminal Control program (which then executes 
as the initial task) . 

TERMINATING THE SYSTEM 

System termination is provided for through use of the master terminal 
transaction (CSMT) and several CICS-provided programs (DFHMTP, DFHSTP, 
DFHSTKC, DFHSTTD, DFHSTTR) . The Termination program (DFHSTP) allows 
normal completion of transactions currently in progress, prepares 
statistics, closes data sets, and optionally, takes a dump before 
exiting to the operating system. 

A detailed description of the use of the transaction CSMT in 
terminating the system is found in the appropriate CICS Operations 
Guide. 



PROCESSING DUM P DATA SETS 

The dump data set produced by the Dump Management facility of CICS 
is a sequential data set, on either magnetic tape or disk, which exists 
in a semi-processed form. The CICS-provided utility program (DFHDUP) 
is used to produce the final formatted dump. The user can define an 
alternate as well as a primary dump data set. 

Unless the user chooses to provide an alternate dump data set, DFHDUP 
must be used only when CICS is not in real-time execution. That is, 
if the user wishes to print the dump data set, he must first terminate 
CICS, run DFHDUP, then reinitialize CICS. This may satisfy the user 
who only requires CICS for a part of the day. 

However, for the user who requires CICS operations for a long period 
of time, an alternate dump data set may be allocated. Thus, at periodic 
intervals, the user may request, through the CICS Master Terminal switch 
function, that CICS begin using the alternate dump data set so that 
the primary data set can be processed by DFHDUP in another 
partition/region. When the primary data set has been processed, the 
user may again "switch" back to the primary data set and then process 
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the alternate data set. This procedure can be repeated any number of 
times. If tapes are being used, this switching procedure causes the 
old dump tape to be closed and dismounted, and a new tape to be mounted 
and opened. 

If the user switches to the alternate dump data set, then fails to 
process the primary data set before again switching, the dumps on the 
primary data set are destroyed by the CICS Dump Management facility 
when new dumps are recorded. 

A detailed description of the use of the Dump Utility program is 
found in the appropriate CICS Operations Guide. 
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SYSTEM GENERATION 



GENERAL DESCRIPTION 

Generation of CICS/DOS is accomplished in three stages: Stage I 
consists of the assembly of the CICS/DOS generation macro instructions 
and the preparation of the input for Stage II; Stage II consists of 
the assembly of the CICS/DOS system; and Stage III consists of the link 
editing of the non-real-time system and tables used by the System 
Initialization program to the DOS Core Image Library using the DOS 
Linkage Editor (LNKEDT) and the link editing of the CICS/DOS real-time 
system to the CICS/DOS Real-Time Relocatable Program Library (DFHRPL) 
using the CICS/DOS Linkage Editor (DFHLINK) . 

Generation of CICS/OS is accomplished in a two-stage operation: (1) 
assembly of the generation macro statements and (2) the running of the 
job stream produced by this assembly. 

During the generation of CICS, the user must specify the CICS 
management programs and system service programs he reguires to meet 
his environmental needs. The specification and naming of the desired 
programs are accomplished through the use of DFHSG system generation 
macro instructions, which are processed by the Assembler. 

The order in which DFHSG macro instructions are specified is not 
important, except that the first macro instruction specified must be 
the DFHSG TYPE=INITIAL macro instruction. In the CICS/DOS systems, 
the DFHSG TYPE=FINAL macro instruction must be the last statement of 
the system generation input stream preceding the Assembler END 
statement. 

DFHSG macro instructions are written in Assembler language and, as 
all Assembler language instructions, are written in the following 
format: 

Name Oper ati on Ope ran ds Co mme nts 

blank DFHSG One or more operands 

or separated by commas 

symbol 

In this publication, parentheses are used to indicate those operands 
where more than one applicable parameter (keyword and otherwise) can 
be specified with a single use of the operand. Where parentheses are 
not used, only one parameter at a time can be specified as part of the 
operand; a choice must be made in the case of more than one applicable 
parameter. Since a blank character indicates the end of the operand 
field, the operand field must not contain blanks except after a comma 
on a continued card or after the last operand of the macro instruction. 
The first operand of a continued card must begin in column 16. 

The following operands can be included in the DFHSG macro 
instruction: 

DFHSG TYPE=INITIAL, * 

STATUS=FIRST, * 

ASMBLR=Assembler name, * 

OPSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMECTL=YES,NO, * 

DSIZE=number, * 
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MPS=YES,NO, * 

JOBNAME=jobname, * 

ACCTID=accounting information, * 

PGMERID=» programmer f s name 1 , * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CONDCD= ( (code, operator) , . . . , (code, operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=x, * 

CLASS=jobclass, * 

REGI0N= (nlK,n2K) , * 

PROCNMS= (procedure names), * 

DL1=YES,N0, * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCTUA= (V1COMPAT, VARIABLE) 

DFHSG PROGRAM=CSO, * 

MPS=YES,NO, * 

NSD=number, * 

DEVICE=2311, 2314, 3330, * 

SVC=number, * 

CAA=appendage suffix, * 

V1CMPAT=YES, * 
TCAMSIP=YES 

DFHSG PROGRAM=CSS 

DFHSG PROGRAM=CSD 

DFHSG PROGRAM=CSU, * 
DEVICE= (TAPE, 2311, 2314, 3330) 

DFHSG PROGRAM=KCP, * 

CONSEC=YES, * 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQUEDE=YES, * 

OPSECUR=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHR=symbolic name, * 
DEVICE= (2311,2314,3330) 

DFHSG PROGRAM=SCP, * 

XTYPREQ=symbolic name, * 
SUFFIX=program suffix 

DFHSG PROGRAM=PCP, * 

PCPLOAD=YES,NO r * 

LANG= (COBOL, PL/I) , * 

HLLTR=YES,NO, * 

COBOL= (V2,V3,V4, SUBSET) , * 

XFETCH=symbolic name, * 
SDFFIX=program suffix 

DFHSG PROGRAM=PIP, * 
SUFFIX=program suffix 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES, * 

ICPTIME=YES, * 
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ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPEEQ=symbolic name, * 

XICEEXP=syinbolic name, * 
DUMMY=YES 

DFHSG PROGRAM=DCP, * 

DEVICE=TAPE, 2311, 2314, 3330, * 

DEVADDR=nnn, * 

CICSDMP=YES, * 

SUFFIX=program suffix, * 
DUMMY=YES 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM,BSAM,SAM,EGAM,TCAM) , * 

DEVICE= (14 03,14 04,14 42,14 43,144 5,2311,2314,3 330, * 

2501, 2520, 2540, CRLP,EASD, DISK, TAPE) , * 

BTAMDEV=(1030,10 50,10 50D,1053,1130,1130D,20 20,2020D, * 

2260,L2260,226 5,2740,2 74 0D,2740-2,2741C, * 
274 1E,2741DC, 2741 DE, 2760, 2770, 2770D, 2780, 2780D, * 

29 80/1, 2980/2, 2980/4, 3275, 3277, L3277, 3284, * 
L3 28 4,328 6,L3286,373 5D,7770,SYS/3,SYS/3D,SYS/7, * 

SYS/7D,S/360,S/360D,S/370,S/370D,TWX,BISYNC) , * 

FEATURE=(AUTOANSW,AUTCPOLL,BUEFRECV,PSEUDOBIN) , * 
ANSWRBK=(EXIDVER, TERMINAL, AUTOMATIC, 7770TERM,7770NUIL) , * 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSCOEE= (EBCDIC, ASCII, TRANSCODE) , * 

ADTOTRN=YES, * 

UCTBAN=NO, (EBCDIC, ASCII) , * 

CCMEAT=NO, (FORMAT, FOLLBUF) , * 

FMT2260=(6X40, 12X40, 12X80, 15X64) , * 

FMT3270=(12X40, 24X80) , * 

CMPT60L= (n1,n2,n3) , * 

SMI=user character, * 

TAB=YES,NO, * 

CCNVTAE=(AEE,ABC) , * 

XATTACH=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=syrabolic name, * 

XTCMIN=syrabolic name, * 

XICMODT=symbolic name, * 

TCM3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SUFFIX=program suffix 

DFHSG PROGRAM=FCP, * 

CONSEC=YES, * 

FILSERV=(INEA,INIS,EAUPD,ISUPD,DAADD,ISADD,INDIRACC, * 

EXCTL,INSEG,ODTSEG,EABLKNG,VLR,HEXAC,EECAD, * 

ACTAD,IVBR, LOCATE, IBROWSE,DBROWSE) , * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XOUTPOT=symbolic name, * 

XINPDT=symbclic name, * 

XINPUTC=symbolic name, * 
DDMMY=YES 

DFHSG PROGRAM=TDP, * 

INTRA=YES,TRANSINIT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SUFFIX=program suffix, * 
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DEVICE=2311, 231U, 3330, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbclic name, * 
DUMMY=YES 

DEHSG PEOGRAM=TSP, * 

DEVICE=2311, 2314, 3330, * 

SUF?IX=program suffix, * 

VIRTUAL=VIRTUAL,REAL, * 

XTYPEEQ=symbolic name, * 

XO01PUT=symbclic name, * 

XINFUT=symbclic name, * 
DUMMY=YES 

DFHSG PEOGRAM=CSA, * 

WRKAREA=number, * 

SUFFIX=program suffix 

DEHSG PEOGRAM=MTP, * 

TLT=YES,NO 

DEHSG PROGRAM=OCP 

DEHSG PROGRAM=GAP 

DEHSG PROGRAM=HLL, * 

LANG= (COBOL, PL/I) , * 

PL1= (0,E) 

DEHSG PROGRAM=DDM 

DFHSG PROGRAM=ATP, * 

INBDFE=number, * 

OUTBUFF=number 

DEHSG TYPE=FINAL 

Table 1 shows the symbolic names and program codes used during CICS 
generation in the specification and naming of CICS management programs 
and system service programs. 
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Table 1 (Part 1 of 2) . 



Symbolic names and program codes used in system 
generation 



PROGRAM NAME 



Terminal Control 
3270 Basic Mapping 

Support 
Terminal Dependent 

Control 
Task Control 
File Control 
Program Control 
Storage Control 
Dump Control 
Transient Data 

Control 
Common System Area 
CICS Dummy CSA 
Temporary Storage 

Control 
Interval Control 
Program Interrupt 
Dump Utility 
CICS/DOS Linkage Editor 
Master Terminal 

programs 



Asynchronous Trans- 
action Processor 
Asynchronous Trans- 
action Reader 
Asynchronous Trans- 
action Writer 
Asynchronous Trans- 
action Queue Purge 
Dynamic Open/Close 
Graphic Attention 
System Service 

programs 
Sign-On 
Sign-Off 

Field Engineering 
Control System Dummy 

programs 
Transient Data dummy 
Dump Control dummy 
File Control dummy 
Temporary Storage 

dummy 
Interval Control 

dummy 
Control System 

Operational programs 
Abnormal Condition 
Terminal Abnormal 

Condition 
Time Adjustment 
Transmission Error 
System Initialization 



SYMBOLIC NAME 
(Note if 


PROGRAM CODE 
(Note 2) 


PROGRAM 


TYPE 


DFHTCP (Note 


6) 


TCP 




Control 


program 


DFHBMSMM 




TCP 




Service 


program 


DFHTDCP 




Note 


9 


Service 


program 


DFHKCP (Note 


6) 


KCP 




Control 


program 


DFHFCP (Note 


6) 


FCP 




Control 


program 


DFHPCP (Note 


6) 


PCP 




Control 


program 


DFHSCP (Note 


6) 


SCP 




Control 


program 


DFHDCP (Note 


6) 


DCP 




Control 


program 


DFHTDP (Note 


6) 


TDP 




Control 


program 


DFHCSA (Note 


6) 


CSA 




Control 


program 


DFHDCSA 




Note 


10 


Control 


program 


DFHTSP (Note 


6) 


TSP 




Control 


program 


DFHICP (Note 


6) 


ICP 




Control 


program 


DFHPIP (Note 


6) 


PIP 




Control 


program 


DFHDUP 




csu 




Service 


program 


DFHLINK 




INITIAL 


Service 


program 


DFHMTPA 




MTP 




Service 


program 


DFHMTPB 




MTP 




Service 


program 


DFHMTPC 




MTP 




Service 


program 


DFHMTPD 




MTP 




Service 


program 


DFHMTPE 




MTP 




Service 


program 


DFHMTPF 




MTP 




Service 


program 


DFHATP 




ATP 




Service 


program 


DFHRD1 




ATP 




Service 


program 


DFHRD2 




ATP 




Service 


program 


DFHWT1 




ATP 




Service 


program 


DFHWT2 




ATP 




Service 


program 


DFHAQP 




ATP 




Service 


program 


DFHOCP 




OCP 




Service 


program 


DFHGAP 




GAP 




Control 


program 






CSS 




Service 


program 


DFHSNP 




Note 


3 


Service 


program 


DFHSFP 




Note 


3 


Service 


program 


DFHFEP 




Note 


3 


Service 


program 






CSD 




Control 


program 


DFHTDPDY 




Note 


4 


Control 


program 


DFHDCPDY 




Note 


4 


Control 


program 


DFHFCPDY 




Note 


4 


Control 


program 


DFHTSPDY 




Note 


4 


Control 


program 


DFHICPDY 




Note 


4 


Control 


program 



DFHACP 
DFHTACP 

DFHTAJP 

DFHTEP 

DFHSIP 



CSO 

Note 
Note 

Note 
Note 
Note 



Control program 
Service program 
Service program 

Service program 
Service program 
Control program 
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Table 1 (Part 2 of 2) 



Symbolic names and program codes used in system 
generation 



PROGRAM NAME 



System Termination 
System Statistics 
programs 

Trace programs 

7770 Read/Write 

7770 Channel/Abnormal 

End Appendage 
7770 SVC 
DL/I Interface 
DL/I Interface dummy 
DL/I Initialization 
DL/I Application 
DL/I CALL Execution 
High-Level Language 

programs 
PL/I-OPT Entry 

Interface 
PL/I-F Entry Interface 
PL/I Interface 
CICS Preprocessor 



SYMBOLIC NAI E 
(Note 1) 


PROGRAM CODE 
(Note 2) 


PROGRAM 


TYPE 


DFHSTP 


Note 


5 


Service 


program 


DFHSTTR 


Note 


5 


Service 


program 


DFHSTTD 


Note 


5 


Service 


program 


DFHSTKC 


Note 


5 


Service 


program 


DFHTRP 


Note 


5 


Service 


program 


DFHTRPDY 


Note 


5 


Service 


program 


DFHRWP70 


Note 


5 


Feature 


program 


DFHCAA70 


Note 


5 


Appendage 


DFHDEB70 


Note 


5 


SVC 




DFHDLI 


Note 


11 


Feature 


program 


DFHDLIDY 


Note 


4 


Feature 


program 


DFHDLA 


Note 


11 


Feature 


program 


DFHDLQ 


Note 


11 


Feature 


program 


DFHDLE 


Note 


11 


Feature 


program 




HLL 




Feature 


program 


DFHPL10I 


Note 


7 


Feature 


program 


DFHPL1I 


Note 


7 


Feature 


program 


DFHSAP 


Note 


7 


Feature 


program 


DFHPRPR 


Note 


8 


Feature 


program 



Note.. 1:. The symbolic name is the name supplied to the linkage edit 
procedure. 

Note 2: The program code. is the keyword parameter used in the system 
generation macro instruction (DFHSG) . 

Note, 3; These programs are included in CICS if the user specifies 
the system service programs with a DFHSG PROGRAM=CSS macro 
instruction. 

Note ff;. These programs are included in CICS if the user specifies 
the control system dummy programs with a DFHSG PROGRAM=CSD 
macro instruction. 

Note 5: These programs are included in the generation of CICS if 

the user specifies the control system operational programs 
with a DFHSG PROGRAM=CSO macro instruction. 

Note 6: A two-character suffix (other than * DY f and 'NO' which are 
reserved) may be appended to these symbolic names. Suffix 
'DY 1 is reserved for dummy programs. 

Note 7: These programs are included in CICS if the user specifies 
the high-level language feature with a DFHSG PROGRAM=HLL, 
LANG=PL/I macro instruction. PLI=(0,F) causes appropriate 
program selection. 

Note 8; This program is included in CICS if the user specifies the 
high-level language feature with a DFHSG PROGRAM=HLL r 
LANG= (COBOL, PL/I) macro instruction. 

No te 9 : This program is included in CICS if the user specifies 
BTAMDEV=1030. 
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Note 10: For CICS/OS, this program is given control by the System 
Initialization program (DFHSIP) via an OS XCTL macro 
instruction to function as the Reguest Block (RB) for CICS. 

Note T _1 1 _; These programs are included in CICS if the user specifies 
DL1=YES in the DFHSG TYPE=INITIAL macro instruction. 

INITIALIZATION OF SYSTEM GENERATION 

The DFHSG TYPE=INITIAL macro instruction must be the first of the 
system generation macro instructions. Procedures developed from the 
use of this macro instruction can be reused for subseguent generations 
of the entire system or for parts of the system. The following operands 
can be included in this macro instruction: 

DFHSG TYPE=INITIAL, * 

STATUS=FIRST, * 

ASMELR= Assembler name, * 

0PSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMFCTL=YES,NO, * 

DSlZE=number, * 

MPS=YES,NO, * 

JOENAME=jobname, * 

ACCTID=accounting information, * 

PGMERID= , programmer 's name', * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CCNECD= ( (code, operator) ,. . . , (code, operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=x, * 

CLASS=jobclass, * 

REGION= (nlK # n2K) , * 

PRCCNHS= (procedure names), * 

DL1=YES,NO, * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCTDA= (V1CMPAT, VARIABLE) 

TYPE: The TYPE=INITIAL operand specifies that this is the initial macro 
instruction in a CICS system generation run. 

STATUS: In the CICS/DOS systems, the STAIUS=FIRST operand must be used 
during the very first CICS/DOS system generation. The presence of this 
operand results in the generation of the CICS/DOS Linkage Editor and 
Library Maintenance program (DFHLINK) . This program is used to place 
all CICS management and application programs in the Real-Time 
Relocatable Program Library (DFHRPL) . 

Once the generation of DFHLINK is complete, it is used to format 
the Real-time Relocatable Program Library. The user must provide a 
label set for DFHNPL in the partition standard label definitions and 
include the DSIZE operand. 

In the CICS/OS system, the STATDS=FIRST operand is used to cause 
the CICS cataloged procedures to be placed in SYS1.PROCLIB. If 
TCTUA=V1COMPAT is specified, jobs are created during stage II of system 
generation that modify the DFHTCT macro instruction and DFHTCT symbolic 
storage definition (DSECT) to provide upward compability from CICS/OS 
Version 1 to CICS/OS Version 2. 
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ASMBLR: This operand is used to identify the name of the Assembler to 
be used during Stage II of system generation and to produce the proper 
JCL. The default is ASMELR=ASSEMBLY for CICS/DOS and ASMBLR=IEUASM 
for CICS/OS. 

For CICS/OS, if the first three characters of the Assembler name 
are 'IEV, Assembler H is assumed and only one work data set is 
allocated (SYS0T1) . Otherwise, Assembler F is assumed and three work 
data sets are allocated (SYSUT1, SYSUT2, and SYSDT3) . 

TRACE: The TRACE=NO operand is used to indicate that the optional 
trace function is not to be used during execution of CICS. The default 
is TRACE=YES. 

TIHECTL: The TIMECTL=NO operand is used to indicate that none of the 
optional time management functions are to be included in any of the 
CICS management programs. If TIMECTL=NO is specified, the macro 
instructions of the Interval Control program (ICP) are not expanded 
and warning messages appear on the assembly listings of the affected 
CICS management programs. The time management functions excluded 
include runaway task control and support of ICP macro instructions. 
The default is TIMECTL=YES. 

DSIZE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the number of directory tracks to be used for the Real-Time 
Relocatable Program Library (created if the STATOS=FIRST operand is 
included) . The default is DSIZE=2. 

MPS: Applicable only to the CICS/DOS systems, this operand is used to 
indicate whether the DOS system for which CICS is being generated has 
multiprogramming system (MPS) support. The default is MES=YES. 

JOENAME: This operand is used to specify a JCL (OS) or job control 
(DOS) jctname for systems generation. The default name is CICS. The 
entire jotname is a concatenation of the jobname operand (truncated to 
four positions) , program name, and suffix. (Example: JCBNAME=NEW, 
PROGRAM=KCP, SUFFIX=01.) The jobname would be NEWKCP01. For the default 
jotname operand, PROGRAM=KCP, SDFFIX=03. The jotname would be CICSKCPO. 
The combined jobname will be truncated to eight positions. 

Note: The program name for DFHSG TYFE=INITIAL is provided by the system 
as GEN. Therefore the default jobname is CICSGEN. 

ACCTID: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the JCL accounting information for the system 
generation procedure. The default is ACCTID=CICSGEN. 

PGMERID: Applicable only to the CICS/OS-STANEARD system, this operand 
is used to specify the programmer's name to be placed in the JCL. The 
name must be enclosed in quotation marks and should not exceed 20 
positions. The default is PGMERID=» SYSTEM PROGRAMMER'. 

MSGLVL: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the message level desired for the JCL during Stage 
II. The default is MSGLVL=0. 
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DEVICE: Applicable only to the CICS/DOS systems, this operand specifies 
for DFHLINK the device type on which the Real-Time Relocatable Program 
Library is resident. This operand is propagated to the DEVICE= 
parameters of DFHSG TYPE=CSO and TYPE=KCP. The default is 2311. 

Note: The Relocatable Program library (DEHRPL) must be on the same 

device type as SYSRES. For the DOS-ENTRY system, the Transaction 
Rollout File (DFHTRF) and the Preallocated Program Library 
(DFHPPL) must also be on the same device type. 

OPSYS: Applicable only to the CICS/OS STANDARD system (release 2.3 or 
later) this operand is used to specify the VS environment in which CICS 
is to be run. For example, OPSYS= (VS1 ,1) is the decimal release number 
of the operating system. In the case of release 2.3, the fix for APAR 
No. P10780 must also be applied. 

CCNDCD: Applicable only to the CICS/OS-STANDARD system, this operand 
is used tc specify up to eight condition codes which, if met on any 
job step, cause further processing of that job to be bypassed. "code" 
can be any decimal number from through 4095. "operator" can be any 
of the following: GT, GE, EQ, LT, LE, NE. For further details, see 
the publication OS Job Control Language (GC2 8-67 04) . 

PRIOBTY: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to assign a priority to the jobs in Stage II of system 
generation. All jobs are given the same priority, where "nn" can be 
any decimal number from through 13. For further details, see the 
publication OS Job Ccntrol Language (GC2 8-67 04) . 

MSGCLAS: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to route all messages issued by the OS Job Scheduler to an 
output class other than the normal message class (A) . "x" can be any 
alphabetic (A-Z) or numeric (0-9) character. If this operand is 
omitted, or if MSGCLAS=A is specified, job scheduler messages are routed 
to the standard output class, A. For further details, see the 
publication OS Job Ccntrol Language (GC28-6704) . 

CLASS: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to assign a jobclass to all Stage II jobs. "jobclass" can be 
an alphabetic character A through 0. If this operand is omitted, or 
if CLASS=A is specified, A is the default jobclass assigned to the 
jobs. For further details, see the publication OS Job Cc ntr ol Language 
(GC28-6704) . 

REGION: Applicable only to -the CICS/OS-STANEARD system, this operand 
allows the user tc (1) specify the maximum amount of main storage to 
be allocated to the job, or (2) specify the maximum amount of main 
storage to be allocated to the jcb and specify in which storage 
hierarchy or hierarchies (if OS/HVT is generated with hierarchy support) 
the space is to be allocated. 

If REGI0N=n1K is specified (for example, REGION=52K) , "n1" indicates 
the number of contiguous 1024-byte areas of main storage to be allocated 
for the job (n1 should be an even number and must not exceed 16383) . 
If REGI0N=(n1K,n2K) is specified (for example, REGION= (60K, 150K) , "n1" 
indicates the number of contiguous 1024-byte areas to be allocated in 
main storage (hierarchy 0) , and "n2" indicates the number of contiguous 
1024-byte areas to be allocated in L.CS (hierarchy 1) . For further 
details, see the publication OS Job Control Language (GC28-6704) . 
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If this operand is omitted, the default value (as established in 
the input reader procedure) is assumed. 

PRCCNMS: Applicable only to the CICS/OS-STANDARD system, this operand 
allows the user to specify the names of CICS cataloged procedures to 
be used as follows: (1) First Name - assembly of CICS programs and 
user written Assembler language programs, (2) Second Name - link edit 
of CICS programs and application programs, (3) Third Name - update of 
a temporary library during system generation, (4) Fourth Name - assembly 
and link edit during the preparation of system tables. The default is 
PRCCNMS= (DFHASMV2,DFH1NKV2,DFHUPDV2,DFHAUPLK) . 

DL1: Applicable only to the CICS/OS-STANDARD system, this operand 
allows the user to specify whether or not the Data Language/I (DL/I) 
interface is to be included in this generation of CICS. The default 
is DI1=N0. 

Note: The Program Specification Directory (PDIR) and Data Management 
Block Directory (DDIR) lists must be in CICS.LOADLIB for the 
link edit of the CICS-DL/I interface modules. Therefore, if 
DI/I is being generated, the lists must be assembled and link 
edited before Stage II of system generation is executed. For 
further information, see the section "Generation of CICS/OS Data 
Language/I Facilities". 

ATP: Applicable only to the CICS/OS-STANDARD and CICS/DOS-STANDARD 
systems, this operand allows the user to specify whether or not 
Asynchronous Transaction Processing (ATP) support is to be included in 
this generation of CICS. The default is ATP=NO. 

PREFIX: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the index name for CICS system data sets. The Job 
Control Language (JCL) generated specifies these data sets as 
prefix. LOADLIB, prefix. MACLIB, and prefix. SOURCE, where "prefix" can 
contain from one to eight characters and must conform to the data set 
naming conventions outlined in the publication OS Job Cont ro l Language 
(GC28-6704) . The default is PREFIX=CICS. 

TCTDA: This operand is used to specify user-defined Process Control 
Information (PCI) fields of fixed length (15 bytes) and/or variable 
length (0-255 bytes) . These fields are located in the Terminal Control 
Table and can be used as terninal work areas. 

TCTUA=V1CMPAT should only be used by CICS/OS Version 1 users who 
are currently using the fixed-length 15-byte PCI field (the address of 
which is at TCTTECI) and who desire Version 2 PCI compatibility with 
Version 1. This operand must be specified in conjunction with the 
STATDS=FIRST operand. 

TCTDA=VARIABLE is used to specify a variable-length (byte aligned) 
PCI field (the address of which is at TCTTECIA and the length of which 
is at TCTTECIL) and should be used by all but CICS/OS Version T users 
(who have used PCI fields) if a terminal work area is desired. The 
default is TCTUA=VARIABLE. 
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CCNTJOL SYSTEM OPERATIONAL GEO DP (CSO) 

The system generation macro instruction necessary to generate the 
Control System Operational group is: 

DFHSG PROGRAM=CSO, * 

MPS=YES r NO, * 

NSD=number, * 

DEVICE=2311, 2314, 3330, * 

SVC=number, * 

CAA=appendage suffix, * 

V1CHPAT=YES, * 
TCAHSIP=YES 

The following Control System Operational modules are generated in 
response to this macro instruction: 

1. System Initialization program (DFHSIP) and its overlays 

2. Trace Control program (DFHTRP) , unless TRACE=NO was specified 
in the DFHSG TYPE=INITIAL macro instruction 

3. A dummy trace program (DFHTRPDY) , unless TRACE=NO was specified 
in the DFESG TYPE=INITIAL macro instruction 

4. System Termination program (DFHSTP) 

5. Abnormal Condition program (DFHACP) 

6. Terminal Abnormal Condition program (DFHTACP) 

7. Terminal Error program (DFHTEP) 

8. Time Adjustment program (DFHTAJP) , unless TIMECTL=NO was 
specified in the DFHSG TYPE=INITIAL macro instruction 

9. File and Terminal Statistics program (DFHSTTR) 

10. Supervisory Statistics programs (DFHSTKC) 

11. Data Management statistics program (DFHSTTD) 

12. Real-Time Pre-Iocated Program Library DTF - CICS/DOS systems 
only 

13. 7770 Read/Write program (DFHRWP70) - CICS/OS-STANDARD system 
only, and only if SVC and CAA operands are specified 

14. 7770 Channel/Abnormal End Appendage program (DFHCAA70) - 
CICS/OS-STANDARD system only, and only if SVC and CAA operands 
are specified 

15. 7770 SVC program (DFHDEB70) - CICS/OS-STANEARD system only, and 
only if SVC and CAA operands are specifeid 

16. DL/I Interface program (DFHDLI) - CICS/OS-STANDARD system only, 
and only if DI1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

17. DL/I Interface dummy program (DFHDLIDY) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

18. DL/I Initialization program (DFHDLA) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

19. DL/I Application program (DFHDLQ) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction. 

20. DL/I CALL Execution program (BFHDLE) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

EROGRAM: The ERCGRAH=CSO operand is used to indicate that the Control 
System Operational group is being generated. 

MPS: The MPS=NO operand is used to indicate that the DOS system for 
which CICS/DOS is being generated does not have multiprogramming system 
(MPS) support. The default is MPS=YES. Applicable only to the CICS/DOS 
systems. 
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NSD: Applicable only to the CICS/DOS systems, this operand is used to 
specify the maximum number of nonsequential disk extents that will 
exist for any data set involved in the real-time execution of CICS. 
CICS system generation uses this value to determine the amount of main 
storage to be reserved at the beginning of the partition for label 
processing when the data sets are opened. Although most data sets are 
opened during system initialization, the dynamic open/close feature of 
the CICS Master Terminal program may require the use of this label 
processing area at any time during CICS execution. The presence of 
this operand makes it unnecessary for the user to supply a DOS LBLTYP 
job control statement with his CICS execution deck. If this operand 
is omitted, the default is NSD=9. The minimum which may be specified 
is one since CICS opens the Real-time Relocatable Program Library even 
if the user has nc data sets to be opened. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device upon which the Relocatable Program Library 
and the Real-Time Pre-Located Program Library (DOS-ENTRY only) are to 
reside. The default is the value propagated from the DEVICE= operand 
Of DFHSG TYPE=INITIAL. 

SVC: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to specify the SVC number under which the 7770 SVC routine provided 
by CICS is to be link edited to SYS1.SVCLIB. The number specified must 
be in the range 200-255. The default is SVC=200 for system generation 
purposes; however, the SVC is not link edited. This operand is required 
if the ACCMETH=BTAH and ETAMDEV=7770 operands are included in the DFHSG 
PROGRAM=TCP macro instruction. For information concerning adding SVC 
routines to the operating system, see the publication OS System 
Programmer's Guide (GC28-655 0) . 

CflA: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to specify the two-character alphameric suffix to be assigned to 
the 7770 Channel End/Abncrmal End Appendage routine provided by CICS 
when that routine is link edited to SYS1.SVCLIB. The suffix specified 
must be in the range WA-Z9. This operand is required if the 
ACCMETH=ETAM and ETAMDEV=7770 operands are included in the DFHSG 
TROGRAM=TCP macro instruction and if the APPENDG operand is included 
in the DFHTCT TYPE=SDSCI macro instruction during preparation of the 
Terminal Control Table. For information concerning adding appendages 
to the operating system, see the publication OS System Programmer's 
Guide (GC28-6550). 

V1CMEAT: Applicable only to the CICS/OS STANDARD system, V1CHPAT=YES 
must be specified if the user wishes to have the Terminal Abnormal 
Condition program (DFHTACP) provide a CICS/OS Version 1 interface when 
linking to the user-written Terminal Error program (DFHTEP) under 
CICS/OS Version 2. This operand is to be used only by those former 
CICS/OS Version 1 users who have an existing DFHTEP. 

TCAMSIP: Applicable only if TCAH is used in the CICS/OS-STANDARD 
system, this operand is used to generate TCAM support in the System 
Initialization program (DFHSIP) . 
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C C NT BO I . SYSTEM SERVICE GROUP (CSS) 

The system generation macro instruction necessary to generate the 
Ccntrcl System Service group is: 

DFHSG PROGRAM=CSS 

The programs generated by this macro instruction are as follows: 

1. Sign-on program (DFHSNP) 

2. Sign-off program (DFHSFP) 

3. F.E. Terminal Test program (DFHFEP) 

CONTROL SYSTEM PSUM GROUP (CSD) 

If the user does not reguire a particular CICS management program 
(for example. File Ccntrcl) , he can elect to not generate that program 
and, as a result, save the amount of static main storage that would be 
reguired to contain the program. However, a dummy program must be 
provided for every CICS management program not actually generated. 

If the Control System Dummy group is generated in response to the 

DFHSG PROGRAM=CSD 

macro instruction, dummy programs with the suffix 'DY 1 are produced 
for the following: 

1. File Ccntrcl program 

2. Transient Data Ccntrcl program 

3. Dump Ccntrcl program 

4. Temporary Storage Ccntrol program 

5. Interval Ccntrcl program 

6. DL/I Interface program 

This facility permits all dummy programs to be generated without 
generating each one separately. 

CCNTROL SYSTEM UTILITY GROUP (CSU) 

The system generation macro instruction necessary to generate the 
Ccntrol System Utility group is: 

DFHSG PRCGRAM=CSU, 

DEVICE=(TAPE,2311,2314,33 30) 

The Dump Utility program (DFHDUP) is generated in response to this 
macro instruction. 

PROGRAM: The PRCGRAH=CSU operand indicates that the Control System 
Utility group (currently consistently only of DFHDUP) is to be 
generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type(s) of input devices (s) . The default is 
DEVICE=(TAPE,2311, 2314, 3330) . 
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CONTROL SYSTEM MANAGEMENT PROGRAMS 

TASK CONTROL PROGRAM (KCP) 

The system generation macro instruction necessary to generate the 
Task Control program is as fellows: 

DEHSG PROGRAM=KCP, * 

CONSEC=YES, * 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQUEOE=YES, * 

OPSECUR=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES / * 

SUFPIX=prograra suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHR=symbolic name, * 
DEVICE= (231 1, 2 3 1U, 3 33 0) 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PRCGRAM=KCP operand indicates that the Task Control 
Program is to be generated. 

CONSEC: Applicable only to the CICS/DCS-ENTRY system, the CONSEC=YES 
operand causes logic to be generated in Task Control that limits the 
number of consecutive I/O's initiated by File Control. When the 
specified limit (contained in the CSA at CSAKCCDL) is reached, the task 
is rolled out. This consecutive dispatch limit is specified in the 
System Initialization Table. 

RUNAWAY: The RUNAWAY=YES operand indicates that the optional runaway 
task control feature of Interval Control is to be supported by Task 
Control. 

STALCTL: The STALCTL=YES operand indicates that the optional stall 
detection feature of Task Control is to be included in CICS. If this 
operand is specified, DFHACP must be made resident. 

ENQUEUE: The ENQUEUE=YES operand indicates that the optional 
enqueue/degueue feature of Task Control is to be included in CICS. 
This operand must be included if the exclusive control feature is to 
be generated as part of the Pile Control program. 

OPSECUR: The OPSECUR=YES operand indicates that the optional operator 
security checking feature of Task Control is to be included in CICS. 

ICFTIME: The ICPTIME=YES operand indicates that the optional 
time-of-day feature of Interval Control is to be supported by Task 
Control. 

ICPAUTO: The ICPAUTO=YES operand indicates that the optional automatic 
task initiation feature of Interval Control is to be supported by Task 
Control. 
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ICPSYNC: The ICPSYNC=YES operand indicates that the optional task 
synchronization service of Interval Control is to be supported by Task 
Ccntrol. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Task Ccntrol program being assembled. If this operand 
is omitted, a suffix is not provided. 

XTYPEEQ: This operand is used to generate linkage to a user-written 
exit routine at the pcint in Task Ccntrol prior to determining what 
type of request for task services was issued. For further information 
concerning user exits, see the section "Creating User Exits for CICS 
Management Programs". 

XDSPCHE: This operand is used to generate linkage to a user-written 
exit routine at a point in the Task Dispatcher subsequent to determining 
which task to dispatch but prior to passing control to the task. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

DEVICE: Effective only in the CICS/DOS-ENTRY system, a rollout data 
set DTF is generated for the device (s) specified. The default is the 
value prcpogated from the DEVICE= operand of DFHSG TYPE=INITIAL. 

STORAGE CCNTROL PROGRAM (SCP) 

The system generation macro instruction necessary to generate the 
Storage Ccntrcl program is: 

DFHSG PROGRAM=SCP, * 

XTYPREQ=symbolic name, * 

SUFFIX=prograra suffix 

PROGRAM: The PROGRAM=SCP operand indicates that the Storage Control 
program is to be generated. 

XTYPREQ: This operand is used to generate linkage to a user-written 

exit routine at the entry point of Storage Ccntrcl. For further 

information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Storage Ccntrcl program being assembled. If this operand 
is omitted, a suffix is not provided. 
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FBOGEAM CONTROL FECGEAM (PCP) 

The system generation macro instruction necessary to generate the 
Program Control program is: 

DFHSG PEOGBAM=PCP, * 

PCPLOAD=YES,NO, * 

LANG= (COBOL, PL/I) , * 

HLLTB=YES,NO, * 

C0B0L=(V2,V3,VU, SUBSET) , * 

XFETCH=symbolic name, * 
SUFFIX=program suffix 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PEOGEAM: The PROGRAM=PCP operand indicates that the Program Control 
program is to be generated. 

PCpLOAD: The PCPL0AD=NO operand is used to specify that the optional 
support for the Program Ccntrcl Load feature is net to be generated. 
PCPLOAD=YES must be specified in order to use a Sign-on Table or a 
Terminal List Table or if application programs use either the DFHPC 
TYPE=LOAD or the DFHBMS macro instruction. See System Service Tables. 
The default is PCPLOAD=YES. 

LANG: This operand is used to specify that the optional support for 
ANS COBOL and/or PL/I is to be generated. 

HLLTR: This operand is used to specify that support for BFHTR (trace) 
macro instructions is to be generated for high-level language 
application programs. If this operand is used, the LANG operand must 
also be used. The default is HLLTE=NO. 

CCBCL: This operand is used to indicate which ANS COBOL compilers are 
to be used to compile user-written application programs. C0B0L=V2 
indicates that the ANS COBOL Version 2 Compiler (360N-CB-482 for DOS, 
360S-CE-545 for OS) is to be used; C0BCL=V3 indicates that the ANS 
COBOL Version 3 Compiler (5736-CB2 for DOS, 573U-CB1 for OS) is to be 
used; C0B0L=V4 indicates that the ANS COBOL Version 4 Compiler 
(5734-CB2) for OS is to be used. The SUBSET parameter indicates that 
the DOS Subset Compiler (5736-CB1) is to te used. If this operand is 
used, LANG=COBOL must also be specified. The default is COBOL=V3. 

XFFTCH: This operand is used to generate linkage to a user-written 
exit routine at the point in Program Control following the loading of 
the reguested program. For further information concerning user exits, 
see the section "Creating User Exits for CICS Management Programs". 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Program Ccntrcl program being assembled. If this operand 
is omitted, a suffix is not provided. 
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PROGRAM INTERRUPT CONTROL PROGRAM (PIP) 

The Program Interrupt Control program is a generalized program 
interrupt handler that is given control by the operating system via 
the STXIT (DOS) or SPIE (OS) macro instruction. This program is 
reguired under CICS/OS if the runaway task control feature of Interval 
Control is to be supported. 

The system generation macro instruction necessary to generate the 
Program Interrupt program is: 

DFHSG PROGRAM=PIP, * 

SUFFIX= pro gram suffix 

PROGRAM: The PROGRAM=PIP operand is used to indicate that the Program 
Interrupt program is to be generated. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than •NO' which is reserved) for the Program Interrupt 
program being assembled. If this operand is omitted, a suffix is not 
provided. 

INTERVAL CONTROL PROGRAM (ICP) 

The system generation macro instruction necessary to generate the 
Interval Control program is as follows: 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XICEEXP=symbolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=ICP operand indicates that the Interval Control 
program is to be generated. 

If the TIMECTL=NO operand was included in the DFHSG TYPE=INITIAL 
macro instruction, only a dummy Interval Control program is generated. 
If the TIHECTL=NO operand was not included, the remaining operands of 
the DFHSG PROGRAM=ICP macro instruction are applicable and must be 
compatible with the corresponding operands included in the DFHSG 
PROGRAM=KCP macro instruction. 

RUNAWAY: The RUNAWAY=YES operand indicates that the optional runaway 
task control feature of Interval Control is to be included in CICS. 
Note that the Program Interrupt Control program (PIP) is used to support 
this feature and must be generated if the RUNAWAY=YES operand is used 
under CICS/OS. 

ICPTIME: The ICPTIME=YES operand indicates that the optional 
time-of-day feature of Interval Control is to be included in CICS. 
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Note that this operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. 

ICPAUTO: The ICPAUTO=YES operand indicates that the optional 
"time-ordered" automatic task initiation feature of Interval Control 
is to be included in CICS. This feature allows tasks to be 
automatically initiated by CICS at a specified time of day or after a 
specified interval of time has elapsed. Note that the Temporary Storage 
Control program (TSP) is used to support this feature and must be 
generated if the ICPAUTO=YES operand is used. Either this operand or 
ICPSYNC=YES operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. This feature is used by 
application programmers using the DFHIC macro instruction. 

ICPSYNC: The ICPSYNC=YES operand indicates that the optional task 
synchronization feature of Interval Control is to be included in CICS. 
This feature allows tasks to be synchronized with a specified time of 
day or with a specified interval of time. Either this operand or the 
ICPAUTO=YES operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than 'NO' or ' DY 1 which are reserved) for the Interval 
Control program being generated. If this operand is omitted, a suffix 
is not provided. 

XTYPREQ: This operand is used to generate linkage to a user-written 
exit routine at the entry point of Interval Control. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

XICEEXP: This operand is used to allow the Interval Control program 
to generate linkage to a user-written exit routine when an Interval 
Control Element (ICE) has expired. For further information concerning 
user exits, see the section "Creating User Exits for CICS Management 
Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Interval 
Control program is to be generated. If this operand is used, a 'DY' 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy Interval Control program. 
Any other operands which may have been included in the DFHSG PEOGRAM=ICP 
macro instruction are ignored. 
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DUMP CONTROL PROGRAM (DCP) 

The system generation macro instruction necessary to generate the 
Dump Control program is as follows: 

DFHSG PROGRAM=DCP, * 

DEVICE=TAPE, 2311,2314, 3330, * 

DEVADDR=nnn, * 

CICSDMP=YES, * 

SUFFIX=prograra suffix, * 
DUMMY=YES 

Unless otherwise indicated, the omission cf an operand results in 
the corresponding function not being included. 

PROGRAM: The Prcgram=DCP operand indicates that the Dump Control 
program is to te generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of output device. If this operand is omitted, 
DEVICE=TAPE is assumed. 

A particular Dump Control program in the CICS/DOS systems will 
support only one type of output device. If it is desired that different 
device types be used on different runs, more than one Dump Control 
program must be generated using the SUFFIX operand. 

EEVADDR: If the DEYICE=TAPE operand is used, the DEVADDR=nnn operand 
must be used to specify the DOS device address to be assigned for the 
tape drive. It should be a three-digit decimal number with leading 
zeros, if necessary. For example, if SYS008 is the device address to 
be used, DEVADDR=008 must be specified. If the DEVICE=2311 operand or 
the DEVICE=2314 operand is used, the DEVADDR value is picked up from 
the label information supplied for the Dump Control data set. This 
operand is applicable only to the CICS/DOS systems. 

CICSDMP: The CICSDMP=YES operand is used to specify that the optional 
feature of dumping CICS management programs and tables is to be 
generated. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than 'NO 1 or 'DY 1 which are reserved) for the Dump Control 
program being assembled. If this operand is omitted, a suffix is not 
provided. 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Dump 
Control program is to be generated. If this operand is used, a •DY 1 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy Dump Control program. Any 
ether operands which may have been included in the DFHSG PROGRAM=DCP 
macro instruction are ignored. 
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TERMINAL CCNTRCL PROGRAM (TCP) 

The system generation macro instruction necessary to generate the 
Terminal Ccntrcl program is as fellows: 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM, BSAM, SAM, BGAM, TCAM) , * 

DEVICE= (1403,14 04,1442,14 43,1445,2311,2 314,3 330, * 

2501, 2520, 2540, CRLP,DASD, DISK, TAPE) , * 

BTAMDEV=(1030,10 50,1050D,1053,1130,1130D,20 20,2 020D, * 

226 0,L22 60, 2265, 2740, 2740D, 2740-2, 2741C, * 
274 1E, 274 1DC, 2741 DE, 2760, 2770, 2770D, 2780, 2780D, * 

29 80/1, 29 80/2, .2980/4, 3275, 3 277, L3277, 3284, * 
L32 84,3286,L3286,373 5D,7770,SYS/3,SYS/3D,SYS/7, * 

SYS/7D,S/360,S/360D,S/370,S/370D,TWX,BISYNC) , * 

EEATURE=(AUT0ANSW,AUTOP0LL,BUEFRECV,PSEUDOBIN) , * 
ANSWRBK= (EXIDVER, TERMINAL, AUTOMATIC, 7770TERM, 7770NULL) , * 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSCOEE= (EBCDIC, ASCII, TRANSCODE) , * 

AOTCTRN=YES, * 

UCTRAN=NO, (EBCDIC, ASCII) , * 

COMPAT=NO, (FORMAT, FULLBUF) , * 

FMT2260=(6X40, 12X40, 12X80, 15X64) , * 

FMT3270= (12X40,24X80) , * 

CMPT60L=(n1,n2,n3) , * 

SMI=user character, * 

TAB=YES,NO, * 

CONVTAE= (ABE, ABC) , * 

XATTACH=symbolic name, * 

XOUTPUT=syrabolic name, * 

XINP0T=symbolic name, * 

XTCMIN=symbolic name, * 

XTCMO0T=symbolic name, * 

TCM3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SDFFIX=program suffix 

Unless otherwise indicated, the omission cf an operand results in 
the corresponding function not being included. 

PROGRAM: The PRCGRAM=TCP operand indicates that the Teririnal Control 
program is to be generated. 

ACCMETH: This operand identifies the access methods to he used in the 
terminal environment. One or more of the following keyword parameters 
must be specified: 

OTHER OPERAND REQUIRED 

Basic Telecommunication Access Method BTAMDEV 
Basic Sequential Access Method DEVICE 

Sequential Access Method DEVICE 

Graphics Access Method 
Telecommunication Access Method 

BGAM and TCAM are applicable only to the CICS/OS system. BGAM causes 
support for local 2260' s to be generated. If TCAM is specified, CICS 
support for TCAM (360S-CQ-548) is generated. SAM and BSAM are 
functionally synonymous in CICS and can be used interchangeably. Only 
unblocked data sets can be used with SAM or BSAM. 
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In the generation of a TCAM only Terminal Control Program, the 
following operands do not apply: DEVICE, BTAMDEV, FEATURE, ANSWRBK, 
INTTR1, LCCKF, WRAPLST, BSCODE, UCTRAN=ASCII , CONVTAB, XODTPDT, XINPUT. 

DEVICE: This operand identifies the direct access or seguential devices 
that are to be used in the terminal environment. This operand must be 
used if ACCMETH=SAH or ACCMETH=BSAM is specified. For direct access 
devices, specify either the device type or the generic parameter DASD 
or DISK. 

ETAHDEV: This operand identifies the ETAM device types and must be 
present if ACCMETH=BTAM is specified. The applicable keyword parameters 
are: 

1030 Data Collection System 

1050 Data Communication System 

1050 Data Communication System (dial-up) 

1053 Printer on a local/remote 2848 Display Control 

1130 Computing System 

1130 Computing System (dial-up) 

System/360 Model 20 

System/360 Model 20 (dial-up) 

2260 Display Station (remote) 

2260 Display Station (local) 

2265 Display Station 

2740 Communication Terminal Models 1 and 2 

2740 Communication Terminal Models 1 and 2 (dial-up) 

2740 Communication Terminal Model 2 (2740 must also be 
specified) 

2741 Communication Terminal with correspondence code 
2741 Communication Terminal with FTTC/EBCD code 
2741 Communication Terminal with correspondence code 
(dial-up) 

2741 Communication Terminal with PTTC/EBCD code (dial-up) 
2760 Optical Image Unit 
2770 Data Communication System 
2770 Data Communication System (dial-up) 
2780 Data Transmission Terminal 
2780 Data Transmission Terminal (dial-up) 
2980 General Banking Terminal System Model 1 
2980 General Banking Terminal System Model 2 
2980 General Banking Terminal System Model 4 
3275 Display Station (remote) 
3277 Display Station (remote) 
3277 Display Station (local) 
3284 Printer on a remote 3271 Control Unit 
3284 Printer on a local 3272 Control Unit 
3286 Printer on a remote 3271 Control Unit 
3286 Printer on a local 3272 Control Unit 
3735 Programmable Buffered Terminal (dial-up) 
7770 Audio Response Unit Model 3 
System/3 Models 6 and 10 
System/3 Models 6 and 10 (dial-up) 
System/7 

System/7 (dial-up) 
System/360 

System/360 (dial-up) 
System/370 
System/370 (dial-up) 

Common Carrier Teletypewriter Exchange Terminal 
(Model 33/35) 

Binary synchronous devices (for CICS/OS-STANDARD V1 
compatibility) 
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The L2260 parameter is applicable only to the CICS/DOS systems. The 
BISYNC parameter includes 1130, System/360 Model 20, and System/360 
Model 25 or higher. One or more parameters can be included in the 
ETAMDEV operand. 

Individual device type parameters are provided for the BTAMDEV 
operand so that system generation input is self documenting. If the 
parameter length for this operand exceeds assembler limit of 255 
characters for the particular system being generated, synonymous 
parameters can. be omitted. Specifying any one of the parameters from 
a group produces supportive code for all devices in the group. These 
groups are: 

1. 2020,SYS/3,S/360,S/37C,1130,BISYNC 

2. 2020D,SYS/3C,S/36 0D,S/370D,1130D 

3. 3275,3277 

4. 3284, 3286, L3284,L3286 

5. 1053,2260,2265 " 

N ote ; When binary synchronous communication lines are part of the 
user's configuration, it is possible for these communication 
lines to time out if control is not returned to the terminal 
before a timeout can occur. The user can alleviate this 
condition in either of two ways: (1) by having the application 
program issue a CICS Task Control WAIT macro instruction to 
voluntarily relinguish control, or (2) by setting the runaway 
task time interval to a value that causes the long-running task 
to be terminated before the line timeout can occur. 

"FEATDRE: This operand is used to specify the special features present 
in the terminal environment. The applicable keyword parameters are: 

1. AUTOANSW Switched lines 

2. AUTOPOLL Automatic polling feature required for multipoint 

binary synchronous communication terminals 

3. BUFFRECV Buffer feature support for 2740 Model 2 

4. PSEUDOBIN Pseudo-binary transmission code for System/7 

One or more parameters can be included in the FEATDRE operand. 

ANSWEBK: This operand is used to specify the type of terminal 
identification; it must be used if FEATURE=AUTOANSW is specified. The 
parameters of this operand are net mutually exclusive. 

ANSWRBK=EXIDVER specifies that BTAM-expanded ID verification is to 
be employed to identify those terminals which transmit unique 
identification seguences. ANSWRBK=EXIDVER must be specified if 
ETAMDEV=3735D. 

ANSWRBK=TERMINAL specifies that the operator will supply the 
identification for switched lines. 

ANSWREK=AUTOMATIC specifies that automatic terminal identification 
is to be sent by the terminal. 

For terminals that communicate with a 7770 Audio Response Unit, the 
applicable keyword parameters are 7770TERM and 7770UULL. 
ANSWBBK=7770TERM specifies that the operator will supply the terminal 
identification. ANSWRBK=7770NULL specifies that no terminal 
identification is to be sent by either the terminal or operator; 
instead, the Terminal Control program will connect the line to the next 
available terminal in the terminal pool. The default is 
ANSWRBK=7770TEBM, providing BTAMDEV=7770 has also been specified. 
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Note: The ANSWRBK operand must include all keyword parameters for 

which the corresponding parameter is to be included in the DFHTCT 
TYPE=LINE specification during Terminal Control Table 
preparation. 

INITRL: Applicable only to the CICS/OS-STANDARD system, the INITRL=YES 
operand (initial read lock) is used to indicate that all reads from 
other than an application program are with the keyboard lock option. 
The FEATURE=KBRDLOCK operand must be included in the DFHTCT TYPE=LINE 
macro instruction to have the keyboard lock feature operative for that 
line. This operand applies to the 2848 Model 21 and 22 with the 
optional keyboard lock feature. 

LOCKF: The LOCKF=YES operand is used to indicate that the optional 
keyboard lock feature, supporting the 2848 models 21 and 22, is to be 
included in CICS. The FEATURE=KBRDLOCK operand must be included in 
the DFHTCT TYPE=IINE macro instruction to have the keyboard lock feature 
operative for that line. For the CICS/DOS systems, if IOCKF=YES is 
specified and if FEATURE=KBRDLOCK is included in the DFHTCT TYPE=LINE 
macro instruction, the keyboard is locked on all reads including the 
initial read. 

WRAPLST: The WRAPLST=YES operand is used to specify that the optional 
wrap list feature is to be included in CICS. The list to be constructed 
is a wraparound polling list for a nonswitched line. 

BSCODE: This operand is used to indicate what types of binary 
synchronous communication code are to be supported. The default is 
BSCODE= (EBCDIC, ASCII,TEANSCODE) . 

ADTOTRN: The ADTOTRN=YES operand is used to specify that the optional 
automatic transaction initiation feature is to be included in CICS. 
Automatic transaction initiation is specified by the TRANSID operand 
of the DFHDCT macro instruction. 

UCTRAN: This operand is used to generate support for the translation 
of lowercase data to uppercase in 3270 input data streams. If DCTRAN=NO 
is specified, uppercase translation support for the 3270 is not 
generated. The default is DCTRAN=NO. 

If BSCODE-EBCEIC and/or CONVTAB=EBCDIC have been specified for 
particular lines, UCTRAN=EBCDIC specifies that support is to be 
generated for local and remote 3270»s on those lines. If BSCODE=ASCIl 
and/or CCNVTAB=ASCII have been specified for particular lines, 
OCTRAN=ASCII indicates that support is to be generated for remote 3270* s 
en those lines. 

Uppercase translation for the 3270 is performed only on input data 
streams received from those 3270* s for which FEATURE=UCTRAN was 
specified during preparation of the Terminal Control Table. 

COMPAT: This operand is used to generate 2260-compatibility support 
for the 3270 Information Display System. Such support allows the user 
to run his currently operational 2260-based transactions from a 3270. 
If COMPAT=NO is specifi-ed, 2260-compatibility support for the 3270 is 
not generated. The default is CCMPAT=N0. 
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Two racdes of compatibility operation are provided: FORMAT and 
FUILBUF. Either cr both may be specified with a single use of the 
COMPAT operand. If COMPAT is specified, then FMT2260 and FMT3270 must 
be used to specify the screen formats. 

CCMPAT=FORMAT indicates that FORMAT compatibility mode is to be 
generated. FORMAT mode takes full advantage of the 3270 formatting 
and data compression facilities, and is the preferred method of 
2260-compatibility operation, particularly for the operation of remote 
3270's. 

CCMPAT=FULIBDF indicates that FDLLBUF compatibility mode is to be 
generated. FULLBOF mode does not use the 3270 data compression 
facilities and must therefore be used when all lines of input data are 
desired. 

Note: If a 480-character 2260 is mapped onto a 480-character 3270, 

use of FOBMAT mode causes the loss of the last character of each 
2260 output line. Use of FDLLBUF mode limits the data loss to 
the last character position of the last line but at the expense 
of transferring a full 480 characters for each interaction 
involving a data entry key. 

FMT2260: This operand is used tc specify the various 2260 screen 
formats to be simulated for 2260-based transactions on the 3270 
Information Display System. The applicable keyword parameters are: 

240-character 2260 Display station 
480-character 2260 Display Station 

960-character 2260 Display Station or 12-row, 80-column 
format for the 2265 Display Station 
4. 15X64 15-row, 64-column format for the 2265 Display Station 

FMT3270: This operand is used to specify the 3270 screen formats on 
which 2260 screen formats are to be simulated for 2260-based 
transactions. The applicable keyword parameters are: 

1. 12X40 480-character 3275/3277 Display Station 

2. 24X80 1920-character 3275/3277 Display Station 

CMPT60L: This operand specifies the minimum size of the Terminal 
Input/Output Area (TIOA) that will be passed when an input operation 
completes for any transaction running under 2260 compatibility. This 
operand must be specified if any of the transactions that are to be 
run under 2260 compatibility reguire an input TIOA larger than the 
standard compatibility default. This operand corresponds in function 
to the INAREAL= specification formerly made in the DFHTCT TYPE=LINE 
macro instruction for the 2260/2265 configuration. 

The n1 parameter specifies the minimum size TIOA for a 3270 simulating 
a 240 character screen sized 2260/2265, the n2 parameter specifies the 
minimum for a 480 screen size simulation, and the n3 parameter specifies 
the minimum for a 960 screen size simulation. The default values are 
CMFT60L= (240,480,960) . If a value is supplied for any of the parameters 
which is smaller than its corresponding default, the default value will 
be taken. 

SMI: This operand is used to specify the character that is to represent 
the start of message indicator (SMI) in all messages to and from the 
3270 operating in 2260 compatibility mode. This character is generated 
as a X^A* and must be a valid alphameric displayable character. If 

36 



the SMI character is contained in an output data stream, its display 
is dependent upon the language feature specified for the 3270. Whatever 
character is chosen, it remains the same for all transactions. The 
default is SMI=£. 

TAB: TAE=YES must be specified if any of the 2260-compatible 3270 
transactions make use of the 2260 tab feature. In this case, all colon 
(:) characters are hbnored as 2260 tab characters when included in the 
output data stream. The default is TAB=NO. 

CCNVTAB: This operand is used to specify the type of conversion to be 
performed on the data received from the 7770 Audio Response Unit. 
CCNVTAE=AEB specifies conversion from ABB 1 transmission code; 
CCNVTAE=ABC specifies conversion from ABC transmission code. Either 
cr both may be specified with a single use of the CONVTAB operand. If 
this operand is used, ACCMETH=BTAH and BTAMDEV=7770 must also be 
specified. The default is CONVTAB= (AEB, ABC) . 

XATTACH: This operand is used to generate linkage in the Terminal 
Ccntrcl program to a user-written exit routine. The linkage is 
generated at the point prior to issuing a Task Control ATTACH for a 
transaction identification which is received in response to polling. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs" or the section "CICS/TCAM 
Interface Considerations". 

XODTPDT: This operand is used to generate linkage in the Terminal 
Ccntrcl program to a user-written exit routine. The linkage is 
generated for output events at the point prior to translating or framing 
output data. For further information concerning user exits, see the 
section "Creating User Exits for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the Terminal 
Ccntrcl program to a user-written exit routine. The linkage is 
generated at the point following completion of any input event. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XTCMIN: Applicable only to the CICS/OS system, this operand is used 
to generate linkage in the Terminal Control program TCAM module to a 
user written exit routine. The linkage is generated following 
completion of any input event. For further information concerning TCAM 
user exits, see the section "CICS/TCAM Interface Considerations". 

XTCMOUT: Applicable only to the CICS/OS system, this operand is used 
to generate linkage in the Terminal Control program TCAM module to a 
user written exit routine. The linkage is generated for output events 
at the point prior to placing data on the output gueue. For further 
information concerning TCAM user exits, see the section "CICS/TCAM 
Interface Considerations". 

TCM3270: Applicable only to the CICS/OS system, this operand is 
reguired if TCAM support is to include the 3270 Information Display 
System. 
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TCM7770: Applicable only to the CICS/OS system, this operand is 
required if TCAM support is to include the 7770 Audio Response Unit. 

BMS: This operand is used to generate the Basic Mapping Support module 
(DFHBMSMM) and tie necessary support code in the Terminal Control 
program for Basic Mapping Support (BMS) . If BMS=YES is specified, a 
corresponding entry (DFHEMSMM) must be included during preparation of 
the Processing Program Table (PPT) . The default is BMS=NO. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Terminal Control program being assembled. If this 
operand is omitted, a suffix is not provided. 

FILE CCMBCL PBCGEAM (FCP) 

The system generation macro instruction necessary to generate the 
File Control program is as follows: 

DFHSG PROGEAM=FCP, * 

CONSEC=YES, * 

FILSERV= (INDA,INIS,EAUPD,ISUPD,EAADD,ISADD,INDIRACC, * 
EXCTL,INSEG,OUTSEG,EABLKNG,VLR,HEXAB,DECAD, ACT AD, * 

IVBR, LOCATE, IBROWSE,DBROWSE) , * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 

XINPOTC=syrabolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

EROGEAM: The PROGBAM=FCP operand indicates that the File Control 
program is to be generated. 

CCNSEC: This operand is effective only in the CICS/DOS-ENTRY system; 
it causes logic to be generated in File Control that limits the number 
of consecutive I/O events initiated by File Control that can occur on 
behalf of a given task. When the limit (contained in the CSA at 
CSAKCCDL) is reached, the task is rolled out by Task Control. This 
facility helps protect CICS from being "seized" by a single task. This 
consectuive dispatch limit is specified in the System Initializetion 
Table. 

FILSERV: This operand is used to specify which of the file services 
are to be generated into the File Control program. The applicable 
keyword parameters are as follows: 

Input DAM 

Input ISAM 

Update DAM 

Update ISAM 

Add DAM 

Add ISAM 

Indirect accessing 

Exclusive control (reguires Task Control enqueue 

feature) 
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Input segmenting 

Output segmenting 

Direct access blocking 

Variable length-records 

Hexadecimal relative track addressing (DAM) 

Zoned decimal relative track addressing (DAM) 

Actual track addressing (DAM) 

ISAM variable-length records (CICS/DOS only) 

Dynamic open/clcse/locate 

ISAM seguential record retrieval 

DAM sequential record retrieval 

Any number of these keyword parameters can be included in the FILSERV 
operand or CSMT File Service functions. 

N ot es: Use of the file browse option under CICS/OS reguires that the 
user create the CVT macro and place it in SYS1 . MACLIB. For 
guidance in creating the CVT macro instruction, see the CICS/OS 
Operations Guide. 

LOCATE must be specified when DFHOCP is generated. 

LOCATE must be specified if the Master Teminal facility is used 
tc access data base. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than *DY' which is reserved) for the File Control program 
being assembled. If this operand is omitted, a suffix is not provided. 

XTYPREQ: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided prior 
to determining what type of request for file services was issued. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XOUTPUT: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided prior 
to writing data in response to an output request. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the File Control 
program tc a user-written exit routine. The linkage is provided after 
the File Control Table (FCT) is searched in response to an input 
request. For further information concerning user exits, see the section 
"Creating User Exits for CICS Management Programs". 

XINPUTC: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided upon 
completion of an input event but prior to deblocking requested input 
records. For further information concerning user exits, see the section 
"Creating User Exits for CICS Management Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy File 
Ccntrcl program is to be generated. If this operand is used, a 'DY' 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 
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This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy File Control program. Any 
ether operands which may have been included in the DFHSG PROGRAM=FCP 
macro instruction are ignored. 

TRANSIENT EATA CONTROL PECGBAM (TDP) 

The system generation macro instruction necessary to generate the 
Transient Data Ccntrcl program is as follows: 

DFHSG PEOGBAM=TDP, * 

TNTRA=YES,TRANSINTT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SDFFIX=program suffix, * 

DEVICE=2311, 2314, 3330, * 

XTYPHEQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbclic name, * 
DUMHY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=TDP operand indicates that the Transient Data 
Ccntrcl program is to be generated. 

INTRA: The INTRA=YES operand specifies that intrapartition data sets 
are to be used. The INTBA=TRANSINIT operand is used to specify that 
intrapartition data sets are to be used and that the automatic task 
initiation feature is also to be included. For further information 
concerning intrapartition data sets, refer to Transient Data Services 
section of the CICS Application Programmers Reference Manual SH20-1047. 

EXTRA: This operand specifies that extrapartition data sets are to be 
used. EXTRA=ACQDISITION indicates input from an extrapartion data set. 
EXTRA=DISPOSITION indicates output to an extrapartition data set. One 
or both of these parameters can be included in this operand. For 
further information concerning extrapartition data sets, refer to 
Transient Data Services section of the CICS Applicat io n Progra mm ers 
Reference Manual SH20-1047. 

SUFFIX: This operand is used to provide a two-character suffix (other 
than ■DY 1 which is reserved) for the Transient Data Control program 
being assembled. If this operand omitted, a suffix is not provided. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device on which the intrapartition data set 
resides. The default is DEVICE=2311. 

XTYPEEQ: This operand is used to generate linkage in the Transient 
Data Ccntrcl program to a user-written exit routine. The linkage is 
provided prior to determining what type of reguest for Transient Data 
services was issued. For further information concerning user exits, 
see the section "Creating User Exits for CICS Management Programs". 

XOUTPUT: This operand is used to generate linkage in the Transient 
Data Control program to a user-written exit routine. The linkage is 
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provided after locating the appropriate entry in the Destination Control 
Table (DCT) but prior to writing data in response to an output request. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the Transient Data 
Control program to a user-written exit routine. The linkage is provided 
after acquiring data in response to an input request. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Transient 
Data Control program is to be generated. If this operand is used, a 
'DY' suffix is automatically generated for the dummy program; any use 
of the SUFFIX operand is ignored. 

This operand is used in lieu of the DFESG PROGEAM=CSD macro 
instruction to selectively generate a dummy Transient Data Control 
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program. Any other operands which may have been included in the DFHSG 
PROGRAM=TDP macro instruction are ignored. 

TEMPORARY STORAGE CONTROL PROGRAM (TSP) 

The system generation macro instruction necessary to generate the 
Temporary Storage Ccntrol program is as follows: 

DFHSG PROGRAM=TSP, * 

DEVICE=2311, 2314,3330, * 

SUFFIX=program suffix, * 

VIRTUAL=VIRTUAL,REAL, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=TSP operand indicates that the Temporary Storage 
Control program is to be generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device on which the temporary storage data set 
resides. This operand is required in the CICS/DOS-ENTRY system; it 
can be omitted in the CICS/DOS-STANDARD system if the temporary storage 
data set resides in main storage. The default is DEVICE=2311. 

SUFFIX: This operand is used to provide a two-character suffix (other 
than 'NO' or ' DY ' which are reserved) for the Temporary Storage program 
being assembled. If this operand is omitted, a suffix is not provided. 

VIRTUAL: This operand specifies whether Temporary Storage is to be 
run in a real or virtual environment. Specification of VIRTUAL for 
this operand generates a Temporary Storage program capable of running 
in a V=V or V=R environment, but consumes a greater amount of address 
space. Specifying REAL generates a Temporary Storage program capable 
of running only in a V=R environment. 

Note: This operand is valid only for CICS/OS STANDARD Version 2.3 with 
the fix for APAR No. P10780 applied or for later releases. 

XTYPREQ: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to determining what type of request for Temporary 
Storage services was issued. For further information concerning user 
exits, see the section "Creating User Exits for CICS Management 
Programs". 

XOUTPUT: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to writing data in response to an output request. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 
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XINPUT: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to returning control to the application program after 
servicing an input reguest. For further information concerning user 
exits, see the section "Creating User Exits for CICS Management 
Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Temporary 
Storage program is to be generated. If this operand is used, a , DY I 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy Temporary Storage Control 
program. Any other operands which may have been included in the DFHSG 
PROGRAM=TSP macro instruction are ignored. 

COMMON SYSTEM ARM (CSA) 

The system generation macro instruction necessary to generate the 
Common System Area is as follows: 

DFHSG PROGRAM=CSA, * 

WRKAREA=number, * 

SUFFIX=program suffix 

In addition to generating the CSA r the execution of this macro 
instruction causes the assembly of Terminal Controls TCA, Task 
Control's TCA, and, in the CICS/DOS systems, a Write to Operator (WTO) 
routine. In the CICS/OS system, a dummy CSA is also generated. 

PROGRAM: The PROGRAM=CSA operand indicates that the Common System Area 
is to be generated. 

WRKAREA: This operand is used to specify the number of bytes to be 
allocated to the common work area portion of the CSA. This area is 
initially set to binary zeros and is available to all programs. If 
the WRKAREA operand is omitted, the size of the work area defaults to 
512. The maximum size for the work area is 3584 bytes. 

SUFFIX: This operand is used to provide a two-character suffix for 
the CSA being generated. If this operand is omitted, a suffix is not 
provided. 

MASTER TERMINAL PROGRAM (MTP) 

The system generation macro instruction necessary to generate the 
Master Terminal program is: 

DFHSG PROGRAM=MTP, * 

TLT=YES,NO 

PROGRAM: The PROGRAM=MTP operand indicates that the Master Terminal 
program is to be generated. 

TLT: The TLT=NO operand indicates that the user does not desire to 
use the Master Terminal program to load Terminal List Tables during 
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real-time execution of CICS. TLI=YES indicates that the Master Terminal 
program vill be used to lead a Terminal List Table to change the status 
of a class of terminals and/or ensure that a supervisory terminal 
operator can change the status of only those terminals under his 
control. The default is TLT=YES. 

Note: If the Master Terminal facility is used to access data base, 
LOCATE must be specified on the FILSEBV operand of the DFHSG 
PECGEAM=FCP macro instruction. 

DYNAMIC OPEN/CLOSE PEOGRAM (OCP) 

The system generation macro instruction necessary to generate the 
Dynamic Open/Close program is: 

DFHSG PEOGBAM=OCP 

This macro instruction must be issued if the Dynamic Open/Close program 
is to be used either through the Master Terminal facility or in response 
to a DFHOC reguest in an application program. Whenever this program 
is used, FCP must be generated with FILSEEV= (. . . , LOCATE) . 

GRAPHIC ATTENTION PROGRAM (GAP) 

The system generation macro instruction necessary to generate the 
Graphic Attention program is: 

DFHSG PEOGBAM=GAP 

This macro instruction is effective only in the CICS/OS-STANDAED system 
and is used to generate support for the local 2260. 

HIGH-LEVEL LANGUAGE SUPPORT GBOUP (HLL) 

The system generation macro instruction necessary to generate the 
High-Level Language Support group is: 

DFHSG PBOGBAM=HLL, * 

LANG= (COBOL, PL/I) , * 

PL1=(0,F) 

The support programs generated in response to this macro instruction 
are as fellows: 

1. CICS preprocessor program (DFHPEPB) - for either or both 
languages 

2. Entry Interface program (DFHPL1I) for PL/I F and/or for PL/I 
Optimizer (DFHPL10I) 

3. PL/I Interface program (DFHSAP) for PL/I F and/or for PL/I 
Optimizer (DFHPL10I) 

PEOGEAM: The PECGBAH=HLL operand indicates that the High-Level Language 
Support group is to te generated. 

LANG: This operand is used to identify the languages for which support 
is to be generated. 

PL1: Applicable only to the CICS/OS system, this operand is used to 
identify the PL/I compilers for which support is to be generated. The 
default is PL1=F. If both compilers are to be used, PL1=(0,F) must be 
specified. 
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TERMINAL DEPENDENT CCNTRCL PROGRAM (TDCP) 

The system generation macro instruction necessary to generate the 
Terminal Dependent Control program is: 

DFHSG PROGRAM=DDM 

This macro instruction must be issued when using 1030 terminals. 

ASYNCHRONOUS TRANSACTION PROCESSING GROUP (ATP) 

The system generation macro instruction necessary to generate the 
Asynchronous Transaction Processing group is: 

DFHSG PROGRAM=ATP, * 

INBUFF=number, * 

OUTBUFF=number 

The following programs are generated in response to this macro 
instruction: 

1. Asynchronous Transaction Control program (DFHATP) 

2. Asynchronous Transaction Input Processing programs 
(EFHRD1 and DFHRD2) 

3. Asynchronous Transaction Output Processing programs 
(DFHWT1 and DFHWT2) 

4. Asynchronous Queue Purge program (DFHAQP) 

Note that this macro instruction is effective only if ATP=YES was 
included in the DFHSG TYPE=INITIAL macro instruction. 

PROGRAM: The PRCGRAH=ATP operand indicates that the Asynchronous 
Transaction Processing group is to be generated. 

INBUFF: This operand is used to specify the size (in bytes) of the 
input buffer used by the Asynchronous Transaction Input Processing 
programs. The value specified should not exceed full track capacity 
for the devica being used, or, in the case of CICS/OS, should not exceed 
the block size specified on the intrapartition data set data definition 
(DD) card at start-up time. 

OUTBUFF: This operand is used to specify the size (in bytes) of the 
output buffer used by the Asynchronous Transaction Control program. 
The value specified should not exceed full track capacity for the device 
being used, or, in the case of CICS/OS, should not exceed the block 
size specified on the intrapartition data set data definition (DD) card 
at startup time. 

TERMINATION OF CICS/DOS SYSTEM GENERATION 

Terminating JCI for Stage II is produced in response to the 

DFHSG TYPE=FINAL 

macro instruction. This macro instruction is effective only in the 
CICS/DOS systems and must be the last statement of the CICS/DOS system 
generation input stream preceding the Assembler END card. 
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GENERATION OF CICS/OS DATA LANGU AGE /I FACILI TIES 

To provide CICS/OS application programs optional access to the Data 
Language/I (DL/I) facility of the IBM Information Management System 
(IMS/360) , the following steps are necessary: 

1. Generate an IMS/360 Version 2 Data Base System capable of 
executing batch IMS/360 programs. This system must be 
Modification Level 2 or later. 

2. Indicate during generation of CICS that application programs 
can access DL/I. This is done by coding 

DFHSG TYPE=INITIAL,DL1=YES 

3. Generate a System Initialization Table (SIT) which includes 
parameters for the CICS-DL/I interface. Applicable parameters 
are DL1, PSB, BUFPL, PSBPL and DMBPL; these parameters may be 
included or overridden at execution time. 

4. Include the following CICS options during generation of CICS: 

a. Task Control ENQUEUE/DEQUEUE 

b. File Control LOCATE 

c. Interval Control program (ICP) 

5. Generate IMS/360 Control Blocks as detailed below. 

DEFINING PSB'S AND PCB'S 

The CICS-DL/I interface has the following requirements for Program 
Specification Block (PSB) generation: 

1. A special initialization PSB is used by CICS-DL/I Initialization 
to bring the proper DL/I modules into storage. This PSB, called 
the "initialization" PSB is not used by any transaction. Program 
Communication Blocks (PCB's) are defined within the PSB to 
indicate what type of CALL'S and data bases DL/I will be called 
upon to service. The following rules apply. 

a. Define one data base PCB (TYPE=DB) for each of the following 
access methods to be used: HSAM, HDAM. 

b. Define two data base PCB's for the same data base for each 
of the following access methods to be used: HISAM, HIDAM. 
These PCB's will be referred to as a PCB pair. Their 
specification causes BISAM rather than QISAM to be used. 

c. Within each PCB, define PROCOPT (processing options) to 
include all processing options to be performed against all 
the data bases using that access method. That is, if one 
HDAM data base is to be accessed via PROCOPT=GE and another 
via PROCOPT=GRP, the combined PROCOPT to be specified is 
PROCOPT=GRPE. 

d. For each PCB being defined, provide one SENSEG statement. 
For the PCB pairs required for HISAM or HIDAM (see above) , 
the SENSEG statements must refer to the same segment type. 
If the use of QISAM is desired in addition to BISAM, provide 
an additional SENSEG statement in one PCB of the PCB pair. 

e. In the PCB statement, specify KEYLEN to be the length of 
the key field defined in the SENSEG statement in (d) above. 
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f. The last statement preceding the END statement in the 
assembly should be written: 

PSBGEN LANG=ASSEM,PSBNAME=psbname 

If DL1=YES is specified during CICS System Initialization, 
the PSB used is named CICS PSB unless overriden in the System 
Initialization Table or by the execution time PSB parameter. 

2. If an application programmer does not name a PSB in the DL/I 
CALL, the PSB used has the name of the program whose name is in 
the Program Control Table (PCT) entry for this transaction. 
Therefore, for all transactions with DL/I CALL*s where the PSB 
name is not specified, there must be a PSB generated with the 
same name as the program name in the PCT entry for the 
transaction. For PL/I programs, specify that the PSB is for 
PL/I. 

3. If an application programmer names a PSB in the DL/I CALL, there 
must be a PSB generated with the name used in that CALL. For 
PL/I programs, specify that the PSB is for PL/I. 

The CICS-DL/I Interface uses the pre-built blocks feature of DL/I. 
After all Program Specification Blocks (PSB's) and Data Base 
Descriptions (DBD's) have been generated, the user must then generate 
Application Control Blocks (ACB's) in the IMS/360 ACB Library for all 
PSB's to be used. The instructions for this generation are included 
in the IMS/360 Utilitie s Manual. 

DEFINING PSB AND DMB DIRECTORIES DURING CICS GENERATION 

A PSB Directory (PDIR) list and DMB Directory (DDIR) list must be 
built for the CICS-DL/I Interface. Each of these lists is built by a 
separate assembly and link edit. Both lists are then included in the 
link-edit of DFHDLQ as described in the CICS/OS Operations Guide. 

PS B Dire ctory List 

Each PSB excluding the initialization PSB, to be used by transactions 
is defined via the statement: 

label DFHDLPSB PSB=psbname 
The last statement in the assembly preceding the END statement is: 

label DFHDLPSB TYPE=FINAL 
The NAME card for the Linkage Editor is written: 

NAME DFHDLPSB (R) 
DMB Dir ectory List 

Each Data Base Description (DBD) used by the system is defined via 
the statement: 

label DFHDLDBD (INDEX,) DBD=dbdname 

where the positional operand, INDEX, indicates that this is a DFHDLDBD 
statement for the INDEX DBD of a HIDAM data base. 
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The last statement in the assembly preceding the END statement is: 

(label) DFHDLDBD TYPE=FINAL 
The NAME card for the Linkage Editor is written: 

NAME DFHDLDBD (R) 
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SYSTEM TABLE PREPARATION 



CICS is dependent upon user-created system tables which describe 
the user's data base/data communications environment and the treatment 
the user wishes given to the elements of that environment. Contained 
in the system tables is information regarding the user's terminals, 
data sets (permanent and temporary) , programs, and transactions. These 
tables are created independently of system generation. However, they 
are reguired for the system to be operational. 

CICS is dynamically configured under user control during system 
initialization. The desired system tables are selected by the user, 
based on a standard naming and suffixing convention. Each of the tables 
is created separately and may be recreated at any time prior to system 
initialization. More than one system table of each type can be 
maintained at the same time. This allows the user to maintain special 
tables for testing in addition to the operational tables. 

The system tables are prepared (generated) by assembling the 
appropriate macro instruction and its associated operands using the 
Assembler program. The output of each assembly contains the reguired 
Linkage Editor control cards. The tables are named in the following 
manner: 

TABLE NAME 

System Initialization Table DFHSITxx 

Terminal Control Table DFHTCTxx 

File Control Table DFHFCTxx 

Destination Control Table DFHDCTxx 

Program Control Table DFHPCTxx 

Processing Program Table DFHPPTxx 

The first six positions are standard for each of the tables. The 
last two positions (xx) may be specified by the user to allow several 
versions of a table to be maintained; any two characters (other than 
'NO') are valid. The suffix which the user assigns to a table is used 
to determine which version of that table is to be loaded into the system 
during system initialization. 

When generating system tables, the assembly of each table must be 
terminated by an Assembler END statement which includes a mandatory 
label (symbol) of the form DFHxxxBA, where xxx is the three-character 
table designation (for example, END DFHFCTBA terminates the assembly 
of the File Control Table) . 

See the appropriate CICS Operations Guide for details concerning 
the link editing of the tables. 

A detailed description follows of what is reguired to complete the 
control cards or macro instructions for each of the system tables. 

SYSTEM INITIALIZATION TABLE (SIT) 

The initialization of CICS is both flexible and dynamic. The 
flexibility at the time of initialization is provided by the System 
Initialization Table (base name: DFHSIT) . The contents of the DFHSIT 
macro which is assembled as a table supplies the System Initialization 
program with the information to initialize the system to meet the user's 
unigue environment. During the initialization process, the user is 

48 



given an opportunity to dynamically change some of the parameters, as 
required. 

The information contained in DFHSIT may be grouped into three 
catagories for purposes of discussion: 

1. Information used to initialize and control system functions (for 
example, storage cushion size, system partition/region exit time 
interval, etc.) . 

2. Module suffixes used to load the user-specified version of the 
CICS control modules and tables (for example, DFHPCTxx, DFHFCPxx, 
etc. ) . 

3. Special information used to control the initialization process. 

The user also has the flexibility of generating several System 

Initialization Tables and selecting the appropriate one at the time of 
initialization. 

The following operands can be included in the DFHSIT macro 
instruction: 

DFHSIT TYPE=CSECT,DSECT, * 

SUFFIX=xx, * 

TRT=decimal value, * 

SCS=decimal value, * 

SP1=decimal value, * 

DVT=2311, 2314, 3330, * 

MSGLVL=0,1, * 

TSBLK=decimal value, * 

ICV=decimal value, * 

ICVS=decimal value, * 

ICVR=decimal value, * 

CDL=decimal value, * 

MXT=decimal value, * 

TCT=xx, * 

PPT=xx, * 

PCT=xx, * 

FCT=xx,NO, * 

DCT=xx # NO, * 

CSA=xx, * 

KCP=XX, * 

SCP=XX, * 

PCP=xx, * 

DCP=xx,NO, * 

ICP=xx,NO, * 

TCP=xx, * 

FCP=xx, * 

TDP=xx, * 

TRP=xx, * 

PIP=xx,NO, * 

TSP=xx,NO, * 

OSCOR=decimal value, * 

PL1=YES,N0, * 

DL1=YES,N0, * 

PSB=name, * 

PSBPL=number, * 

DMBPL=number, * 

BUFPL=number, * 

ATP=YES,NO, * 

ATPHT=number, * 

ATPMB=number, * 
SIM0DS=(A2,B1,C1,C2,C3,D1,E1) or 
(A2,B1,C1,D1,E1) 
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TYPE: Specifies whether a CSECT or DSECT of the System Initialization 
Table is to be generated. If alternate or additional System 
Initialization modules are coded by the user, a DSECT may be required 
to provide symbolic addressability to values in the table. The default 
is TYPE=CSECT. 

SUFFIX: Specifies a two-character alphameric suffix for the System 
Initialization Table being assembled. This suffix, if specified, is 
appended to the standard module name (DFHSIT) and is used to name the 
module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 

TRT: Specifies the number of entries that are to be provided in the 
CICS Trace Table. If the user has not generated the Trace facility, 
this operand should be ignored or set to 0. (See the discussion of 
DFHSG TYPE=INITIAL.) If Trace has been generated and this parameter is 
0, a dummy Trace facility is loaded (DFHTRPDY) . The default is TRT=0. 

SCS: Specifies the number of bytes (minimum 20) which are to be 
reserved for the storage cushion. The default is SCS=500. 

SP1: Specifies the number of bytes to be reserved for subpool 1 storage 
in the CICS/DOS-ENTRY system. The default is SP1=0. To arrive at the 
size required, refer to "Storage Estimates and Considerations" in the 
CICS General Information Manual (GH20-1028) . 

DVT: Applicable only to the CICS/DOS systems, this operand specifies 
the device type on which the CICS/DOS system data sets reside. These 
data sets include the following: 

1. CICS Real-Time Relocatable Program Library 

2. CICS Real-Time Pre-Located Program Library (CICS/DOS-ENTRY system 
only) 

3. CICS Transaction Rollout Data Set (CICS/DOS-ENTRY system only) 

Since no default is provided, 2311, 2314 or 3330 must be specified. 

MSGLVL: Specifies a message level of either or 1 which controls the 
generation of messages to the console during system initialization. 
MSGLVL=0 allows only critical I/O errors or interactive messages to 
appear. MSGLVL=1 allows all messages to be printed. The default is 
MSGLVL=1. 

TSBLK: Applicable only to the CICS/DOS systems, this operand specifies 
the maximum block size (as a decimal value) for records on the auxiliary 
temporary storage data set. The default is TSBLK=3625. 

ICV: Specifies the system partition/region exit time interval in 
milliseconds. The default is ICV=1000. For further information 
concerning exit time interval, see the section "System Administration". 

ICVS: Specifies the system stall time interval in milliseconds as a 
decimal value. The default is ICVS=20000. For further information 
concerning stall time interval, see the section "System Administration". 
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ICVR: Specifies the runaway task time interval in milliseconds as a 
decimal value. The default is ICVR=5000. If ICVR=0000 / runaway task 
control is suspended for the duration of the current execution of CICS. 
For further information concerning runaway task time, see the section 
"System Administration". 

CDL: Applicable only to the CICS/DOS-ENTRY system, this operand 
specifies the consecutive dispatch limit as a decimal value. The 
default is CDL=5. 

MXT: This operand is used to specify the maximum number of tasks (both 
synchronous and asynchronous tasks in the case of the CICS/DOS-STANDARD 
and CICS/OS-STANDARD systems) that can be initiated concurrently within 
CICS. When the number of active tasks reaches this level, no new tasks 
are initiated by the Terminal Control program. The default is MXT=5. 

TCT...TSP: Each of the operands contained in Figure 1 allows the user 
to specify a two-character suffix which is appended to the standard 
name before loading the CICS nucleus. For example, KCP=B1 causes the 
DFHKCPB1 Task Control module to be included in the CICS nucleus. In . 
each case, the default suffix is blank. 

E PROGRAM 

Terminal Control Table 
Processing Program Table 
Program Control Table 
File Control Table 
Destination Control Table 
Common System Area 
Task Control Program 
Storage Control Program 
Program Control Program 
Dump Control Program 
Interval Control Program 
Terminal Control Program 
File Control Program 
Transient Data Program 
Trace Control Program 
Program Interrupt Program 
Temporary Storage Program 

Note: If NO is coded, a dummy module is loaded (except in the case 
of PIP where the program interrupt facility is not provided 
if NO is coded) . FCT=NO and DCT=NO cause a dummy FCP and 
a dummy TDP to be loaded, respectively. For CICS/OS, PIP 
must be included in the CICS nucleus if the runaway task 
control feature is to be supported. 

Since CICS does not provide generatable options for DFHPIP 
and DFHTRP, PIP=xx and TRP=xx are used, respectively, only 
if the user wishes to provide his own version of these 
programs, or if the user specified a suffix when generating 
PIP, then that suffix should be used in the SIT. 
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DFHTCT 
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DFHPPT 
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KCP=xx 




DFHKCP 
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DFHICP 
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DFHFCP 
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NO 


DFHTSP 



Figure 1. Resident program suffixes 



OSCOR: Applicable only to the CICS/OS-STANDARD system, this operand 
specifies a one- to six-digit decimal value indicating the amount of 
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main storage to be provided from the CICS partition/region for the use 
of the operating system during CICS execution. The default is OSCOR=0; 
however, the minimum amount of main storage available to the operating 
system is equal to the size of the System Initialization program 
(DFHSIP) . 

If the value specified is greater than the size of DFHSIP, the amount 
of main storage provided for the use of the operating system is equal 
to the size of DFHSIP plus the amount specified in excess of the size 
of DFHSIP. Note that this main storage is not available to the 
operating system until DFHSIP transfers control to the Dummy CSA program 
(DFHDCSA) . 

The user should be aware that an incorrect OSCOE specification could 
adversely affect system performance. The value specified should 
accurately reflect the amount of main storage required by the operating 
system, depending upon the CICS configuration. 

PL1: The PL1=YES operand indicates that programs coded in PL/I are to 
be processed. The default is PL1=N0. 

DL1: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to indicate whether or not Data Language/I (DL/I) data bases are 
to be accessed during execution of CICS. The default is DL1=N0. 

PSB: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the one- to eight-character name of the Program Specification Block 
(PSB) used during IMS initialization. This PSB contains a Program 
Communication Block (PCB) for each DL/I access method to be used (two 
PCB»s in the case of HISAM) , and is used to load all required DL/I 
modules during initialization. The default is PSB=CICSPSB. 

PSBPL: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the Program Specification Block (PSB) pool size in 1024-byte blocks 
for CICS-DL/I Interface support. The number of 1024-byte blocks 
specified must be in the range 0-999. This operand corresponds to the 
PSB operand of the IMS/360 BUFPOOLS system generation macro instruction 
and to the III parameter of the IMS/360 CTL or CTX parameter list for 
online execution. The default is PSBPL=4. 

DMBPL: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the Data Management Block (DMB) pool size in 1024-byte blocks for 
CICS-DL/I Interface support. The number of 1024-byte blocks specified 
must be in the range 0-999. This operand corresponds to the DMB operand 
of the IMS/360 BUFPOOLS system generation macro instruction and to the 
JJJ parameter of the IMS/360 CTL or CTX parameter list for online 
execution. The default is DMBPL=4. 

BUFPL: Applicable only to the CICS/OS-STANDARD~system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the DL/I data base buffer pool size in 1024-byte blocks. The number 
of 1024-byte blocks specified must be in the range 0-999. This operand 
corresponds to the DBASE operand of the IMS/360 BUFPOOLS system 
generation macro instruction and to the HHH parameter of the IMS/360 
CTL or CTX parameter list for online execution. The default is BUFPL=8. 
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ATP: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 
systems, this operand is used to indicate whether or not the 
Asynchronous Transaction Processing facility (ATP) is to te generated. 
The default is ATP=NO. 

ATFMT: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 
systems, this operand is used to specify, as a decimal value, the 
maximum number of asynchronous tasks that can be initiated concurrently 
within CTCS by the Asynchronous Transaction Processing Control program 
(DFHATP) . When the number of active asynchronous tasks reaches this 
level, nc new asynchronous tasks are initiated by DFHATP. The default 
is ATPHT=1. 

ATPMB: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 
systems, this operand is used to specify, as a decimal value, the 
asynchronous task inhibitor value. When the number of active tasks 
(both synchronous and asynchronous) reaches this level, the Asynchronous 
Transaction Processing Control program (DFHATP) does not initiate any 
new asynchronous tasks, even though the number of asynchronous tasks 
currently active is less than the value specified in the ATPMT operand. 
Thus, even though nc asynchronous tasks are active, none are initiated 
if the tctal of all other active tasks has reached the level specified 
in this operand. If this operand is omitted, the default value is 
egual to one less than the value specified in the MXT operand. 

SIMODS: Applicable only to the CICS/DOS systems, this operand is used 
to change the last two characters of the phase names of the System 
Initialization overlays and/or allow the addition of one user-written 
overlay. The phase names of the System Initialization overlays are 
located in the DOS Core Image Library and must be seven characters in 
length; the first five characters are DFHSI and the last two characters 
are specified through use of this operand. The default is 
SIMODS= (A2,B1,C1,C2,C3,D1,E1) for the CICS/DOS-ENTRY system and 
SIMODS= (A2,B1,C1 ,D1,E1) for the CICS/DOS-STANDARD system. 

The order in which the overlays are executed is determined by the 
sequence of the parameters of the SIMODS specification. For example, 
in response to the SIMODS= (AS,BS,CS,DS,ES) specification, the overlays 
are loaded in the order DFHSIAS, DFHSIBS, DFHSICS, DFHSIDS, DFHSIES. 
In response to the SIMODS= (AS,BS ,CS,DS,DS,ES) specification, the 
overlays are loaded in the order DFHSIAS, DFHSIBS, DFHSICS, DFHSIDS, 
DFHSIUS, DFHSIES. 

If an additional user-written overlay is to be provided, the SIMODS 
specification for the CICS/DOS-ENTRY and CICS/DOS-STANDARD systems 
would contain eight parameters and six parameters, respectively. 

Note: The interface to user-written overlays is subject to change with 
later releases of CICS programs. 

TERMINAL CONTROL TABLE (TCT) 

The Terminal Control Table provides a means whereby the user of CICS 
can specify the terminal environment in which the system will operate. 
The Terminal Control Table contains the data needed by the control 
system to perform its terminal management functions. The user can 
create more than one Terminal Control Table to describe both his 
operational and his terminal testing environment. 

The Terminal Control Table macro instruction (DFHTCT) is used to 
specify the user's terminal environment which can include 
telecommunication devices, sequential processing devices, and graphic 
devices. The following operands can be included in the DFHTCT macro 
instruction: 
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DFHTCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHTCT TYPE=SDSCI f * 

DEVADDR=SYSnnn, * 

DEVICE=1 030, 1050, 1130, 14 03, 14 04, 14 42, 14 43, 1445, * 

2020, 2260, L2260, 2 26 5, 23 11, 231 4, 2501, 2520, * 

25 40, 2740, 2 740/27 60, 274 1C, 2741 E, 2770, 2780, * 

'2980,327 5, 3 277,13277, 32 84, L3284, 3286, L3286, * 
3330,3735,7770,BSCMDMPT,BSCMDPPT,BSCMDSW,DASD, * 

DISK,SYS/3,SYS/7,S3 60,TAPE,TW33,TW35,TCAM, * 

DSCNAME=narae, * 

ERF.OPT=E,R,W,C,N,RW,T, * 

FEATURE=(STC,CHK,BSC,KBL,OIU,SIX,SXW,SIW,RIX, * 

RXW,RIW,MAS,SLV,APL) , * 

LINELST= (nnnl ,. . . ,nnn31) , * 

SWITCH=YES,NO, * 

CD=270 1,27 02, 2703, 2848,3272,7770, * 

CCNFIG=PPT,MPT, * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

MODELST=(n1,.. . ,n31) , * 

RETRY=number, * 

TEEMTST=YES,NO, * 

LERBADR=symbclic address, * 

DDNAME=name, * 

MACRF=(R,W), '* 

FLKNAME=name, * 

NCP=number, * 

MODE=(,CNTRL,A or E,A or B) , * 

BLKSIZE=length, * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=ti,WU,WC,WUC, * 
APPENDG=appendage suffix 

symbol DFHTCT TYFE=LINE, * 

ACCMET H=S AM, BSAM,BTAM, EG AM, TC AM, SEQUENTIAL, GRAPHIC, * 

TELECOMMUNICATION, * 

TRMTYPE=1 030, 10 50, 1053, 113 0,2020, 2260, L2260, 2265, * 

2740, 2740/2760, 274 1C,2741E, 2770, 2780, 29 80, * 
3275, 3277, L3277, 32 84, L3284, 3286, L3286, 3735, 777 0, * 

SYS/3,SYS/7,S360,CRLP,DASD,TAPE,TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY,BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number or character, * 

ETAMRLN=number, * 

LISTADR=(name,tfRAP) , * 

FEATURE= (AUTCANSR, AUTOCALL, AUTOPOLL , CHECKING, * 

SCCNTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

EOCLADR=symbclic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL, EXIDVER, * 

LINS1AT= , OUT OF SERVICE', * 

BSCOEE=EBCDIC, ASCII, TRANSCODE, * 

CONVTAE=EBCDIC, ASCII, TEANSCODE, TEXTMODE, AEE , ABC, * 

RDYMSG=symtclic address, * 

ERRMSG=symbclic address, * 

GENPOLL=YES, * 

PCCLCNT=number, * 

TCTUAL=number, * 

OUTQ=symbolic name, * 

POCL=YES, * 
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QUEUEID=hexadecimal number * 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number, * 

TRMMODL=number, character , * 

TRMTYPE=1030, 1050,105 3,113 0,20 20,2260,12260,2265, * 

2740, 274 0/2760, 274 1C, 2741 E, 2770, 27 80, 2980, * 

3275,3 277,L3277,32 84,L32 84,3286,L3 28 6,3735,7770, * 

SYS/3,SYS/7,S360,CRLP,DASD,TAPE,TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY, BISYNC, AUDIO) , * 

LVUNIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address,name, * 

TRMSTAT= (TRANSACTION, TRANSCEIVE, RECEIVE, « OUT OF SERVICE 1 ,* 

INPUT) , * 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT,SELECTPEN,AUDALARH,COPY,BUFEXP, * 

DCKYBD,UCTRAN) , * 

POLLPOS=number, * 

TRANSID=name, * 

STN2980=number, * 

TAB2980=number, * 

TIOAL=number, * 

TCTUAL=number 

symbol DFHTCT TYPE=7770MSG, * 
MESSAGE=» message' 

DFHTCT TYPE=FINAL 



ESTABLISH CONTROL SECTION FOR TERMINAL CONTROL TABLE 

The area of main storage into which the Terminal Control Table is 
assembled is established in response to the 

DFHTCT TYPE=INITIAL, 
SUFFIX=xx 

macro instruction, which must precede all other DFHTCT macro 
instructions in a Terminal Control Table assembly. 

SUFFIX: This operand specifies a two-character alphameric suffix for 
the Terminal Control Table being assembled. This suffix, if specified, 
is appended to the standard module name (DFHTCT) and is used to name 
the module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 
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SPECIFY DATA SET CONTROL INFORMATION 

The user must specify data set control information through use of 
the 

DFHTCT TYPE=SDSCI 

macro instruction, which causes the control system to generate the 
appropriate data set control information. DTF information is generated 
in the CICS/DOS systems; DCB information is generated in the CICS/OS 
system. This macro instruction can include the following operands: 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSnnn, * 

DEVICE=1 030, 10 50, 1130,1403, 14 04,1442,1443, 1445, * 

2020, 226 0,L2260, 226 5, 231 1,23 14, 250 1,2520, * 

2540, 27 40, 2740/2760, 274 1C, 274 1E, 2770, 2780, * 

2980,3275,3 277,L3277,32 84,L3284,328 6,L3286, * 
3330,37 35,7770,BSCMDMPT,BSCMDPPT,BSCMDSW,DASD, * 

DISK, SYS/3, SYS/7, S3 60, TAPE', TW33,TW3 5, TCAM, * 

DSCNAME=name, * 

ERROPT=E,R,W,C,N,RW,T, * 

FEATURE=(STC,CHK,TRC,BSC,KBL,OIU,SIX,SXW,SIW,RIX, * 

RXW,RIW,MAS,SLV,APL) , * 

LINELST=(nnn1,.. . ,nnn31) , * 

SWITCH=YES,NO, * 

CU=270 1,27 02, 270 3, 2848, 3272, 7770, * 

CONFIG=PPT,MPT, * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

MODELST=(n1,.. .,n31) , * 

RETRY=number, * 

TERMTST=YES,NO, * 

LERBADR=symbolic address, * 

DDNAME=name, * 

MACRF=(R,W) , * 

FLNNAME=name, * 

NCP=number, * 

MODE=(,CNTRL,A or B,A or B) , * 

BLKSIZE=length, * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=W,WU,WC,WUC, * 
APPENDG=appendage suffix 

Two DFHTCT TYPE=SDSCI macro instructions must be coded for each 
sequential terminal. One macro instruction is for the sequential input 
data set and the other macro instruction is for the sequential output 
data set. This input/output data set combination simulates the input 
and output functions of a terminal. One DFHTCT TYPE=LINE macro 
instruction must be coded for this I/O combination. 

One DFHTCT TYPE=SDSCI macro instruction must be coded for each BTAM 
line group, where a line group is a group of communication lines that 
meet the following operational requirements: 

1. All lines in the group are attached to the channel through the 
same type of telecommunications control unit; for example, a 
2701. (This is true only for the CICS/DOS systems.) 

2. The line connection between the control unit and the remote 
devices is of the same type; for example, a switched network. 

3. All devices within the line group have the same line features 
and operating characteristics; for example, autopoll. 
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DEVADDE: Applicable only to the CICS/DOS systems, this operand 
specifies the symbolic unit address (sequential device) used for 
sequential terminal data sets. 

DEVICE: Specifies the valid device types for this Terminal Control 
Table. L2260 siqnifies "local video attachment". 2260 and 2265 siqnify 
"remote video attachment". 13 211, L3284, and L3286 siqnify "local 3270 
attachment". 3275, 3277, 3284, and 3286 siqnify "remote 3270 
attachment". BSCMDPPT siqnifies "mixed binary synchronous 
point-to-point devices". BSCHDSW siqnifies "mixed binary synchronous 
switched devices". ESCMDMFT siqnifies "mixed binary synchronous 
multipoint devices". For direct access devices, specify either the 
device type or the qeneric parameter DASD or DISK. 

The TAPE specification defines the tape as work files for both the 
input and the output data set. Note that if an input tape with an 
expired label is entered, the header may be re-written causinq the 
first "data record (s) to be destroyed. 

Support for a 1053 printer is included when 2260, L2260, or 2265 is 
specified. In the CICS/OS-STANDARD system, this operand automatically 
qenerates the MACBF operand. 

A 2740 Communication Terminal with 2760 Optical Imaqe Onit can be 
specified as either a 2740 or 2740/2760. 

DEVICE=TCAM (applicable only to CICS/OS) causes CICS to qenerate 
the appropriate data set control information to handle the TCAM input 
or output process queue. 

Np..t§.J. In the qeneration of a TCAM only the system, the followinq 

operands do not apply to TCP and TCT: ANSWRBK, BTAMDEV, BSCODE, 

CCNVTAB, FEATURE, INITBL, LOCKF, UCTRAN=ASCII , WRAPLST, XINPUT, 
XO0TPUT. 

DSCNAME: Specifies the symbolic data set control name associated with 
the data set control information. 

The DSCNAME for the sequential input data set must be the same name 
as that specified in the ISAISCN=name operand of the DFHTCT TYPE=LINE 
macro instruction. The DSCNAME for the sequential output data set must 
be the same name as that specified in the OSADSCN=name operand of the 
DFHTCT TYFE=LINE macro instruction. 

The DSCNAME for ETAM data sets must be the same name as that 
specified in the DSCNAME=name operand of the DFHTCT TYPE=LINE macro 
instruction. 

ERROPT: Specifies the error recovery, error recordinq, and online test 
options to be provided for the line qroup. The applicable keyword 
parameters are: 

1. E, specifies that the basic error recovery procedures are to be 
provided for the line qroup. If ERBOPT is omitted, EBROPT=E is 
assumed. 

2. B, specifies that text-read errors are to be retried in addition 
to the basic error recovery . procedures. This option is valid 
only for the followinq terminals: 1050 terminals (valid for 

the card reader and paper tape reader only if the line correction 
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feature is installed) , 2740 terminals with the checking feature, 
and 2260 terminals. 

3. W, specifies that text-write errors are to be retried in addition 
to the basic error recovery procedures. This option is valid 
for all start-stop terminals. It is invalid for binary 
synchronous terminals. It results in an additional copy of the 
message for each retry (except for the 2260 with the line address 
feature, and the 1050 card punch and paper tape punch with the 
line correction feature) . This parameter is ignored for binary 
synchronous terminals. 

4. C, specifies that threshold error counts and cumulative error 
counts are to be maintained in the line error recording block 
(LERB) for the line for data check, intervention required, and 
nontext timeout errors. This parameter is applicable only to 
the CICS/OS-STANDARD system; however, for the CICS/DOS systems, 
the LERB support is generated if the LERBADR parameter is 
specified. 

5. N, specifies that no error recovery procedures are to be provided 
for the line group. This parameter and E,R,W, and C are mutually 
exclusive. This parameter is invalid for binary synchronous 
stations; if coded, it is ignored. 

6. RW, specifies that error recovery is to be performed with "read 
text retry" and "write text retry". 

7. T, specifies that the online test facility is to be used for 
the line group. Applicable only to the CICS/OS-STANDARD system, 
this parameter is valid for all IBM terminals with or without 
error recovery capability. 

Note: For CICS/OS, EROPT is also a valid spelling of this operand. 
Commas must not be coded in this parameter. For example, 
EEEOPT=RECflT. 

FEATURE: Applicable only to the CICS/DOS systems, this operand 
specifies device-dependent machine special features and programming 
special features. The applicable keyword parameters are: 

1. SIC, specifies that the 2740 or System/7 is equipped with the 
station control feature. 

2. CHK, specifies that the 2740 is equipped with checking feature 

(CHK must always be specified for the System/7.) 

3. BSC, must be coded when the DEVICE operand specifies a binary 
synchronous device. 

4. KBL, specifies that the 2848 control unit is equipped with the 
data entry feature. The Lock optypes are rejected as undefined 
if this parameter is not used. 

5. OIU, specifies that a 2760 Optical Image Unit is attached to a 
2740 with the checking feature and, optionally, the dial feature. 

6. SIX, SXW, or SIW, used if ID verification for a calling operation 
is to occur in a binary synchronous point-to-point dial system. 

A more detailed explanation of these codes is given in the 
publication, DO S Basic Telecommunications Access Method 
(GC30-5001). (See Note) 

7. RIX, RXW, or RIfl, used if ID verification for an answering 
operation is to occur in a binary synchronous point-to-point 
dial system. A more detailed explanation of these codes is 
given in the publication, DOS Basic Telecommunications Access 
Method (GC30-5001). (See Note) 

8. MAS or SLV, used to specify whether the CPU is to be Master 
(MAS) or Slave (SLV) when contention occurs in a binary 
synchronous CPU-to-CPU contention system (private line) . If 
this operand is not used, FEATURE=MAS is assumed for this system. 
If FEATURE=MAS is specified, the remote device is to be the 
slave when contention occurs. If FEATURE=SLV is specified, the 
remote device is the master. When the remote device is the 
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2780, FEATURE=SLV must always be coded. The CPU must always be 
the slave when contention occurs between the CPU and the remote 
2780. 
9. AEL, specifies that the autopoll feature is to be employed for 

the start-stop devices. If FEATURE=APL is omitted, the generated 
channel programs for these devices will perform the standard 
programmed polling. A more detailed explanation of this code 
is given in the publication, DOS Basic Telecommunications Access 
Method (GC30-5001). 

N°±e.i These parameters should not be used with "Extended ID 

Verification" i.e., they should not be coded if ANSWREK=EXIDVER 
is coded for TYPE=LINE. 

ITNELST: Applicable only to the CICS/DOS systems, this operand 
specifies the correspondence between symbolic unit (SYSnnn) and relative 
line number. The user codes one three-digit number (nnn of SYSnnn) 
for each line in the line group. The order in which the three-digit 
numbers are coded determines which symbolic units are associated with 
the individual lines in the line group. As many as 31 three-digit 
numbers from 000-244 may be coded in this operand. 

For local 2260's and local 3270's, each number entry represents a 
physical device; all local devices attached to the same control unit 
must be specified in the same LINELST operand. 

SWITCH: Applicable only to the CICS/DOS systems, this operand specifies 
the type cf line connection between the system and the remote device. 
SWITCH=YES indicates that the line connection is through a switched 
network. SWITCH=NO indicates that the line connection is dedicated. 
The default is SWITCH=NO. 

CU: Applicable only to the CICS/DOS systems, this operand defines the 
control unit attached to the channel (such as a 2701, 2702, 2703, 2848, 
3272 or 7770) . This operand is reguired for all non-seguential devices. 
If using the Systera/360 Model 25 with the Integrated Communications 
Attachment, CU=2703 must be specified; for System/370 with Integrated 
Communications Attachment, CU=2701 must be specified. 

CONFIG: Applicable only to the CICS/DOS systems, this operand specifies 
the type of binary synchronous line configuration. CONFIG=PPT indicates 
that the data link between the CPU and the remote binary synchronous 
device is point-to-point. CONFIG=HPT indicates that the data link 
between the CPU and the remote binary synchronous devices is a 
multi-point link. The default is CONFIG=PPT. 

BSCODE: Specifies the type of binary synchronous transmission code. 
BSCODE=EECDIC indicates transmission in Extended Binary Coded Decimal 
Interchange Code. BSCODE=ASCII indicates transmission in American 
Standard Code for Information Interchange. BSCODE=TRANSCODE indicates 
transmission in six-bit TRANSCODE. The default is BSCODE=EBCDIC. 

MODEIST: Applicable only to the CICS/DOS systems, this operand is used 
to specify a code (0,1,2,3) for each line in a binary synchronous line 
group to be used by BTAM at OPEN time. If this operand is omitted, 
code is assumed for each line in the line group. A more detailed 
explanation of this operand is given in the publication DOS Basic 
Telecommunications Access Method (GC30-50 01) . CICS does not support 
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the use of codes 4, 5, 6, and 7. If converting from CICS/DOS to 
CICS/OS, this operand must be recoded as MODE. 

BETBY: Specifies the number of retries (0-15) by BTAM for recoverable 
errors that cccur on I/O operations for binary synchronous 
communication. If this operand is omitted, BETBY=7 is assumed. 

TEBMTST: Applicable only to the CICS/DOS systems, this operand 
specifies whether cr not the online terminal test facility is to be 
used. The default is TEBMTST=NO. A more detailed explanation of this 
operand is given in the DOS Basic Telecommunications Access Method 
publication, (GC30-5001 for DOS Belease 26 or lower, GC27-6978 for DOS 
Belease 27 or higher). For CICS/OS, the online terminal test facility 
is specified through the EBBOPT operand. 

LEBBADB: Specifies the label of the BTAM line error recording block 
(LFRB) in which tie user has specified his LEEB parameters. For 
CICS/OS, this operand is valid only if EEBOPT=C is also specified. For 
CICS/OS, LEBB is also a valid spelling of this operand. 

DDNAME: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to supply the name of the data definition (DD) statement 
associated with a particular data set (line group) . If converting from 
CICS/DOS to CICS/OS and this operand is omitted, the DSCNAME becomes 
the DDNAME. 

MACRF: Applicable only to the CICS/OS-STANDBED system, MACEF=(B,W) 
indicates that access to the BTAM line group or to seguential devices 
is to be gained via either BEAD or WBITE macro instructions, or both. 
The default for ETAM line groups is MACRF=(B,fl) ; the OPEN option for 
ETAM line groups defaults to input. 

For seguential devices (other than card reader and line printer) , 
MACEF=B or MACRF=W must be specified. The default is MACBF=B for a 
card reader and MACBF=W for a line printer. 

FLNNAME: Applicable only to the CICS/OS-STANEABD system, this operand 
specifies the name of the first line entry (DFHTCT TYPE=LINE) for local 
2260's. 

NCP: Applicable only to the CICS/OS-STANEABD system, this operand is 
used to indicate the number of channel programs that are to be specified 
when using the Graphics Access Method. The default is NCP=1. 

MODE: Applicable only to the CICS/OS-STANDABD system, this operand 
specifies the mode of communication for a binary synchronous line group. 
A more detailed explanation of this operand is given in the publication, 
CS Basic Telecommunications Access Method (GC30-2004) . Note that since 
CICS does not support the IBC parameter described in GC30-2004, a comma 
must be substituted in place of the IBC parameter. 

ELKSIZE: This operand is used for seguential data sets and 7770 Model 
3's to specifiy th maximum length (in bytes) of a block. For 7770 
Model 3»s this value should be the same as that specified for INAEEAL 
in the line entries that reference the DSCNAME of this DFHTCT TYPE=SDSC1 
macro instruction. 
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For the CICS/OS-STANDARD system, the default is BLKSIZE=0. If this 
operand is omitted, the block size can be specified in the data 
definition (DD) statement associated with the data set. A more detailed 
explanation of this operand is given in the publication OS Super viso r 
and H&ta Majicicjejiiejit M ac ro Instructions, GC28-6647. 

For the CICS/DOS systems, the default is BLKSIZE=80. A. more detailed 
explanation of this operand is given in the publication DOS Supe rv isor 
and I./0 Macros, GC24-5037. 
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RECFM: Applicable only to the CICS/OS-STANDARD system, this operand 
is used for sequential data sets to specify the record fromat for the 
DCB. Applicable keyword parameters are F (fixed-length records) , V 
(variable-length records) , and U (undefined records) . The default is 
RECFM=U. If this operand is omitted, the record format can be specified 
in the data definition (DD) statement associated with the sequential 
data set. 

SYNAD: Applicable only to CICS/OS with TCAM, this symbolic name 
specifies the address of a subroutine to be given control if message 
processing is used; the work unit is larger than the work area, and 
OPTCD=C is not specified. 

For input queues, the user has the option of specifying his own 
SYNAD routine for which an EXTRN is generated. If SYNAD is not 
specified, a CICS generated SYNAD routine is provided. If CICS SYNAD 
is used and the exit occurs: 

1. Message DFH4000 is issued. 

2. The DCB is closed. 

3. The DCB is reopened. 

4. Data is truncated to the specified blocksize and is passed to 
the CICS application program. 

OPTCD: Applicable only to CICS/OS, this operand specifies the optional 
fields for the TCAM work unit. The W specifies that for input, the 
name of the source of each message is to be placed in an eight-byte 
origin field in the work area. For output, it specifies that TCAM 
expects the name of the destination of the message to be placed in an 
eight-byte destination field in the work area before a TCAM WRITE macro 
instruction is executed. OPTCD=W must be specified for both the input 
and output macro instruction. 

U specifies that the work unit to be handled is either a message or 
a message segment that is not a record. If U is omitted, the work unit 
is assumed to be a record. 

C specifies that a one-byte field in the work area, called the 
position field, indicates whether the work unit being handled is the 
first, an intermediate, or the last segment of the message, and, on 
input, whether a record delimiter has been detected in the data. 

For further information concerning the OPTCD operand, see the OS/MFT 
and OS/MVT TCAM Programmer's Guide (GC30-202U) . 

APPENDG: Applicable only to the CICS/OS-STANDARD system when 
DEVICE=7770 is specified, this operand is used to specify a 
two-character alphameric suffix for the 7770 Channel End/Abnormal End 
Appendage routine. The suffix specified must be in the range WA-Z9 
and must be the same suffix as was specified in the CAA operand of the 
DFHSG PR0GRAM=CS0 macro instruction. 



DESCRIBE COMMUNICATION LINES 

Communication paths to the terminals on the system are described by 
the DFHTCT TYPE=LINE macro instruction. The expansion of this macro 
instruction is the Terminal Control Table line entry (TCTLE) and 
contains the Data Event Control Block (DECB) that is used to communicate 
with the appropriate access method. The terminals related to this line 
must be described immediately following this macro instruction through 
use of the DFHTCT TYPE=TERMINAL macro instruction. However, when 
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describing a switched- line network, all the lines for a given pool 
should be described before describing the terminals for that line pool. 

If TCAM is used, the TCTTE's that follow a TCAM TCTLE represent: 

1. Physical terminals, if POOL=YES is not coded. 

2. The maximum number of tasks (transactions) that can be 
initiated for this TCTLE, if POOL=YES is coded. 

The following operands can be included in the DFHTCT 
TYPE=LINE macro instruction: 

symbol DFHTCT TYPE=LINE, * 

ACCMETH=S AM, BS AM, BTAM,BG AM, TCAM, SEQUENTIAL, GRAPHIC * 

TELECOMMUNICATION, * 

TRMTYPE=1 030,1 050, 1053, 113 0,2020, 2260, L226 0,2265, * 

2740, 2740/2760, 274 1C, 2741 E, 2770, 27 80, 2980, * 
3275,3 277,L3277,32 84,L3284,3286,L3 28 6,3735,7770, * 

SYS/3, SYS/7, S360,CRLP,DASD, TAPE, TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY, BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number, character, * 

BTAMRLN=number, * 

LISTADR= (name, WRAP) , * 

FEATURE= (AUTOANSR, AUTOCALL, AUTOPOLL, CHECKING, * 

SCONTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

POOLADR=symbolic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL, EXIDVER, * 

LINSTAT='OUT OF SERVICE', * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

CONVTAB=EBCDIC,ASCII,TRANSCODE,TEXTMODE,ABB,ABC, * 

RDYMSG=symbolic address, * 

ERRMSG=symbolic address, * 

GENPOLL=YES, * 

POOLCNT=number, * 

TCTUAL=number, * 

OUTQ=symbolic name, * 

PO0L=YES, * 
QUEUEID=hexadecimal number 

One or more DFHTCT TYPE=LINE macro instructions must be coded for 
each line group. The DSCNAME=name operand of each of the DFHTCT 
TYPE=LINE macro instructions must contain the same name as was specified 
in the DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro 
instruction. 

A DFHTCT TYPE=LINE macro instruction must be coded for each logical 
pair of seguential SDSCI macro instructions. 

A DFHTCT TYPE=LINE macro instruction must be coded for each symbolic 
unit (relative line) coded in the LINELST=parameter operand of the BTAM 
SDSCI macro instruction. The DFHTCT TYPE=LINE macro instruction entries 
must be contiguous on switched-line pools. For the local 2260 Display 
Station under CICS/DOS and the local 3270 Information Display System 
under CICS/DOS or CICS/OS, only one DFHTCT TYPE=LINE macro instruction 
is coded for each line group. 

Note: For sequential devices, the last entry in the input stream must 
be ' CSSF GOODNIGHT* to provide a logical close. If all input 

62 



is sequential, 'CSHT SHUTDOWN' must be entered at one of the 
terminals to terminate CICS. 

ACCMETH: This operand is used to specify the access method to be used. 
Grouped according to synonymity of function, the applicable keyword 
parameters are: 

1. SAM, ESAM, SEQUENTIAL 

2. EGAH, GRAPHICS (CICS/OS only) 

3. EIAM, TELECOMMUNICATION 

4. TCAH, TELECOMMUNICATION (CICS/OS only) 

TRMTYPE: This operand is used to specify the terminal type associated 
with this communication line. Only one TRMTYPE operand can be included 
in each DFHTCT TYPE=LINE macro instruction. This operand, when 
specified, establishes the default specification that will be used when 
the TRMTYPE operand is not specified in a DFHTCT TYPE=TERMINAL macro 
instruction associated with this line. If no TRMTYPE operand is 
specified in the DFHTCT TYPE=LINE macro instruction, a TRMTYPE operand 
must be supplied in each DFHTCT TYPE=TERMINAL macro instruction for 
that line. 

The use of the TRMTYPE operand in the DFHTCT TYPE=LINE macro 
instruction is optional unless one of the following conditions exists: 

1. A 7770 is associated with the line. 

2. A local 3270 is associated with the line. 

3. One cr more remote 3270's are associated with the line. 

In each of these cases an appropriate device-type parameter must be 
specified in the TRMTYPE operand; for example: 

1. TRMTYPE=7770 for the 7770. 

2. TRMTYPE=L3277, TBMTYPE=L3284, or TRMTYPE=L3286 for a local 3270. 

3. TRMTYPE=3275, TRMTYPE=3277, TRMTYPE=3284, or TRYTYPE=3286 for 
a remote 3270. 

TWX is the common Carrier Teletypewriter Exchange Terminal Station 
(Model 33/35) , DASD is the direct access storage device, CRLP is the 
card reader and line printer (a pair of sequential devices simulating 
a terminal) , TAPE is the magnetic tape device, and U/R is a general 
term that refers to any reader, printer or punch. 1053 indicates a 
1053 Printer Model 4. 

CLASS: This operand is used to indicate the device classification 
associated with this communication line. The applicable keyword 
parameters are: 

Device with conversational type application 

Data collection type device 

Device with cathode ray tube 

Start/stop hard-copy device 

Binary synchronous device 

Audio response device 

Multiple parameters may be specified, except that parameters within 
the following groups are mutually exclusive: CONV and BATCH; VIDEO, 
HARDCOPY and AUDIO. BISYNC must be specified for any binary synchronous 
line. For example, remote 3270s could be specified 
CLASS= (CONV, VIDEO, BISYNC) and local 3270s CLASS= (CONV, VIDEO) . 
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CONV 


2. 


BATCH 


3. 


VIDEO 


4. 


HARDCOPY 


5. 


BISYNC 


6. 


AUDIO 



ESCNAME: Specifies the data set control information for this 
communication line. It is not applicable for BSAM. The DSCNAME for 
BTAM data sets must be the same name as that specified in the 
ESCNAHE=name operand of the related DFHTCT TYPE=SDSCI macro instruction. 
In case of TCAM, this operand specifies the data set control name for 
ah input TPROCESS queue; the OUTQ operand is also required. 

ISADSCN: Specifies the input BSAM data set control name for a 
particular communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the related 
EFHTCT TYPE=SDSCI macro instruction. This operand is not applicable 
to BTAM, GAM, or TCAM. 

OSADSCN: Specifies the output ESAM data set control name for a 
particular communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the related 
EEHTCT TYPE=SDSCI macro instruction. This operand is not applicable 
to BTAM or GAM. In the case of TCAM, this operand specifies the data 
set control name for an output TPROCESS queue; the OUTQ operand may 
not be used. 

INAREAL: Specifies the messaqe input area lenqth. This value, as a 
ninimum, must be specified as fellows: 

1. For start/stop devices, the lenqth should be equal to the lenqth 
of the lonqest initial sentence of a transaction. 

2. For start/stop devices with the buffer receive feature (for 
example, the 2740 Communication Terminal Model 2) , the lenqth 
should be equal to the lenqth of the buffer less two bytes. 

3. For binary synchronous devices, the lenqth may be calculated as 

(a+1) (b+2) + 1, where "a" is the number of blocks sent by a 
device in response to an RVI (reverse interrupt) from CICS, and 
"b" is the size, in bytes, of each block. 

4. For the local 2260 Display Station under CICS/DOS, the lenqth 
of the input message can at no time be greater than the length 
specified throuqh this operand. 

5. For the remote 3270 Information Display System, the lenqth 
specified should not be less than 254. 

6. For the local 3270 Information Display System, the value 
specified may be any number greater than zero. This value 
indicates the minumum size of the Terminal Input/Output Area 
(TIOA) that will be passed to the transaction by the Terminal 
Control proqram. However, for performance considerations, the 
value specified should be equal to or qreater than the lenqth 
of the expected input message; at no time can a message be read 
whose length exceeds the INAREAL value by more than 2000 bytes 
(unless the transaction provides a TIOA for the read large enough 
to contain the message) . 

7. For sequential devices, the lenqth should be equal to the 
blocksize (and record lenqth) of the data set. 

Note: The mimimum size TIOA passed to a transaction which is runninq 
under control of 2260 compatibility is qoverned by the CMPT60L 
operand in the system qeneration of the Terminal Control proqram 
(DFHSG PRCGRAM=TCP) . 

TRMMODL: This operand specifies the model number of the terminal 
associated with this communication line. This operand must be used if 
the device is one of the followinq: 
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1. Component of the 1050 Data Communication System 

2. 2740 Communication Terminal Model 2 

3. Component of the 2980 General Banking Terminal System 

4. Component of the 3270 Information Display System 

5. 2740 Communication Terminal with 2760 Optical Image Unit 

6. 2260 Display Station 

7. 2265 Display Station 

The TBMMODL parameter sets the default value that will be taken, 
when it is not specified in the DFHTCT TYPE=TERHINAL macro instruction 
associated with that line. If models vary on a line, the macro 
instruction can have a TEMMODL parameter associated with it, which is 
different from that specified in the DFHTCT TYPE=LINE. This will 
override the DFHTCT TYPE=LINE macro for that DFHTCT TYPE=TERMINAL macro. 

TRMM0DL=1 is used to specify the 2980 Teller Station Model 1, 3275 
Display Station Model 1, 3277 Display Station Model 1, 3284 Printer 
Model 1, or 3286 printer Model 1. THMM0DL=1 is the default for the 
3270 Information Display System. 

TRMMODL=2 is used to specify the 2740 Communication Terminal Model 
2, 2980 Administrative Station Model 2, 3275 Display Station Model 2, 
3277 Display Station Model 2, 3284 Printer Model 2, or 3286 Printer 
Model 2. 

TEHMODI=4 is used to specify the 2980 Teller Station Model 4. 

TEMM0DL=5 is used to specify component polling of the keyboard for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 5 (0B) must be coded in the 
polling list (DFTRMLST) . See note. 

TRMMODL=6 is used to specify component polling of reader 1 for the 
1050 Data Communication System using non-switched communication lines. 
Component selection character 6 (0D) must be coded in the polling list 
(DFTEMIST) . See note. 

TRMMODL=7 is used to specify (1) the 2740 Communication Terminal 
with 2760 Optical Image Onit, or (2) component polling of reader 2 for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 7 (0E) must be coded in the 
polling list (DFTEMIST) . See note. 

TBMMODI=0 is used to specify an input component for the 1050 Data 
Communication System. Common polling character (15) must be coded 
in the polling list (DFTEMIST) . TEMMODL=0 is the default specification 
for a 1050 Data Communication System. 

The TEMMODL=character operand is used to specify the applicable 
screen format for a 2260/226 5 Display Station as follows: 

SPECIFICATION SCEEEN FORMAT 

TEMMODL=A 
TRMMODI=B 
TRMMODL=C 
TBMM0DL=D 
TRMMODI=E 

For example, TRHM0DL=A specifies a 2260 Display Station with a 6x40 
screen format. 

Note: When TRMMODL is specified, the user must also specify the 

component selection character with control unit address via the 
TEMADDE operand of the DFHTCT TYPE=TEEMINAL macro. 
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ETAMRLN: Specifies the relative line number within a line group. The 
relative line number can be specified in the range 1-31 for CICS/DOS 
and 1-256 for CICS/OS. This operand is not applicable to BSAM, TCAM, 
local 2260 , s, or local 3270's. 

LISTADR: Specifies the label of the BTAM Define Terminal List macro 
statement (DFTRMLST) in which the user has specified his polling list 
for the communication line. (A terminal may not be specified more than 
once in a polling list.) DFTRMIST entries should be coded immediately 
preceding DFHTCT TYPE=LINE entries or immediately following DFHTCT 
TYFE=TERMINAL entries. If a wraplist is specified in the DFTRMLST, 
the WRAP operand must be included. The default is to an open list. 
LISTADR is not applicable when ACCMETH=BSflM, ACCMETH=GAM, or for some 
devices when ACCHETH=BTAM (for example, dial-up 2741' s). 

The DFTRMIST macro instruction establishes a terminal list from 
which ETAM obtains the information it needs to establish contact with 
a terminal. This information consists of telephone numbers, polling 
and addressing sequences, and identification sequences to be sent to 
terminals, or against which an incomming sequence can be checked to 
ensure that contact has been established with a valid station. 

For more information, see the publication DOS Basic 
Telecommunications Access Method (GC30-5001) or the publication OS 
Basic Telecommunications Access Method (GC30-2004) . 

Note: Polling list entries for remote 2260/2265 and remote 3275/3277 
systems must specify a general poll. The use of a general poll 
allows a single entry in the polling list to invite input from 
all devices attached to each remote control unit or display 
station. 

In this form of operation, the polling list should contain only 
one entry for each 2845, 2848, or 3271 Control Unit or for each 
3275 Display Station on the line. For 2260/2265 display systems, 
this form of operation is achieved by coding X'FF' as the second 
byte of each entry in the polling list. For 3270 systems, this 
form of operation is achieved by using a device address code of 
X'7F' (EBCDIC) or X»22» (ASCII) in each polling list entry 
applicable to a 3271 Control Unit or 3275 Display Station. For 
remote 3270's, see the discussion of GENPOLL in this section 
and the discussion of FOLLPOS in the section "Describe Terminal 
Types". 

If ANSWRBK=EXIDVEF is specified, the LISTADR operand must specify 
the label of a DFTRMLST macro instruction of the SWLST,AN format. The 
user data portion of the entries in this list must be either of the 
following: 

1. The label of the corresponding DFHTCT TYPE=TERMINAL macro 
instruction for each 3735; or 

2. Hexadecimal zeros for terminals that share the line with the 
3735 but do net transmit unique ID sequences. 

For a dial-up line containing 3735's and other bisynchronous devices, 
the answering list must be coded as follows: 

symbol DFTRMLST SWLST, AN, xx, 4 , yy,zz, * 

(authsequence,0,userdata) , , , * 

(2D, 0, ZERO) 

where: symbol is the user label specified by the LISTADR= operand of 
the DFHTCT TYPE=LINE macro instruction, xx,yy,zz as defined in 
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the BTAH manual, (authsequence, 0, userdata) is a sublist in the 
answering list for each 3735 (authsequence is defined in the 
BTAH manual) , must be specified for the control value, userdata 
is the label of the DFHTCT TYPE=TERMINAL entry and (2D, 0, ZERO) 
is a sublist in the answering list for all non-3735 devices on 
the line where 2D is the ID ENQ sequence for non-3735 devices, 
must be specified for the control value, ZERO is the label 
used to represent userdata (the following statement must be 
coded: ZERO EQU 0) . 



FEATURE: 



This operand is used to indicate that one or mere optional 
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features are present on a given terminal. These features can be 
specified in any order using the following keyword parameters: 

1. AUTOANSR, the automatic answering capability for switched lines. 

2. AUTOCALL, the automatic calling capability for switched lines. 

3. AUTOPOLL, the automatic polling capability required for 
multi-point binary synchronous communication terminals and 
optional for the 1050 Communication System and 2740 Communication 
Terminal. If AUTOPOLL is specified for the 2740, SCONTROL must 
also be specified. 

4. CHECKING, the VRC/LRC feature on the 2740 Communication Terminal. 

5. SCONTROL, the station control feature on the 2740 Communication 
Terminal and on the System/7. 

6. BUFFRECV, the buffer receive capability for the 2740 
Communication Terminal Model 2. If BUFFRECV is specified, 
SCONTROL must also be specified. 

7. KBRDLOCK, the lock option capability for the 2848 Display Control 
Models 21 and 22. 

For terminals on switched-line networks, FEATURE=AUTOANSR must always 
be specified. 

NPDELAY: Applicable only to start/stop and BISYNCH devices, this 
operand is used to specify the interval of time, in milliseconds, 
between line polls (invitations) when a negative response to a poll is 
detected. This number can be specified in the range to 20000, with 
default values varying by device type. NPDELAY signifies "negative 
poll delay". 

When used with a TCAM line, this operand specifies the time interval 
that is to expire before control is passed to TEP when a CICS task is 
not ready to accept a subsequent record from the input process queues. 
If the CICS task issues a read before the time interval expires, 
processing continues normally and TEP is not notified. This number 
can be specified in the range of to 20,000 milliseconds. The default 
value is 0. 

POOLADR: This operand must be used for switched-line processing and 
for the local 3270 Information Display System. Used for switched-line 
processing, this operand specifies the label assigned to the first 
terminal description (DFHTCT TYPE=TERMINAL) associated with a particular 
pool of communication lines. POOLADR should be coded only for the 
first line in a given line pool; FEATURE=AUTOANSR must also be 
specified. 

Used for the local 3270 Information Display System, this operand 
specifies the label assigned to the first terminal description 
associated with a particular pool of local 3270«s. FEATURE=AUTOANSR 
need not be specified. 

ANSWRBK: This operand must be coded for switched lines to specify the 
terminal identification to be used. If this operand is used, 
FEATURE=AUTOANSR must also be specified. Only one of the following 
keyword parameters may be specified: 

1. AUTOMATIC, indicates automatic terminal identification. This 

parameter may be coded only for the Common Carrier Teletypewriter 
Exchange Terminal Station (Model 33/35) . 

2'. TERMINAL, indicates that the terminal will be identified by the 
operator. This parameter may be coded for the TWX, 1050, 2740, 
2741, and dial-up binary synchronous devices. (After the dial-up 
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connection has been made, the operator must enter the Terminal 
Identification as it appears in the Terminal Control Table.) If 
3735's share the line, specify EXIDVER. 

3. NULL, indicates that the terminal will not be identified by 
either the terminal or operator. This parameter may be coded 
only for the 7770. (After the dial-up connection has been made, 
the Terminal Control program connects this line to the next 
available terminal in the terminal pool.) 

4. EXIDVER, not applicable to CICS/DOS-Entry, this keyword parameter 
indicates that the terminal 1 s unique ID sequence will be 
identified by BTAM-expanded ID verification. This parameter 
must be coded for any line on which there is a 3735. If devices 
which do not transmit unique ID sequences share the line with 
3735's, the non-3735 operator must enter the terminal 
identification after the dial-up connection has been made. 

Note: These keyword parameters are valid only if the corresponding 
keyword parameters have been included in the DFHSG 
PROGRAM=TCP,ANSWRBK= (parameters) specification during system 
generation. 

LINSTAT: The LINSTAT='OUT OF SERVICE 1 operand indicates that the line 
is to be initiated with an "out of service" status. 

BSCODE: This operand is used to specify the type of communication code 
to be used for a given binary synchronous communication device. The 
applicable keyword parameters are EBCDIC, ASCII, and TRANSCODE. The 
default is BSCODE=EBCDIC. 

CONVTAB: This operand is used to specify the type of transmission 
code, and may be used in lieu of the BSCODE operand for binary 
synchronous devices. The applicable keyword parameters are: 

1. EBCDIC Extended Binary Coded Decimal Interchange Code 

2. ASCII American Standard Code for Information Interchange 

3. TRANSCODE Six-bit transmission code 

4. ABB ABB' code for the 7770 Audio Response Unit Model 3 

5. ABC ABC code for the 7770 Audio Response Unit Model 3 

RDYMSG: Required when TRMTYPE=7770 is specified, this operand is used 
to specify the symbolic address of the ready message used by CICS to 
communicate with terminals attached to the 7770 Audio Response Unit. 
The ready message is defined through the DFHTCT TYPE=7770MSG macro 
instruction. (See the section "Define Digital Response Messages for 
the 7770 Audio Response Unit".) 

ERRMSG: Required when TRMTYPE=7770 is specified, this operand is used 
to specify the symbolic address of the error message used by CICS to 
communicate with terminals attached to the 7770 Audio Response Unit. 
The error message is defined through the DFHTCT TYPE=7770MSG macro 
instruction. (See the section "Define Digital Response Messages for 
the 7770 Audio Response Unit".) 

GENPOLL: GENPOLL=YES must be specified for a multipoint binary 
synchronous communication line if one or more of the polling sequences 
in the DFTRMLST (pointed to by the label specified in the LISTADR 
operand) is a general poll sequence. If this operand is used, the 
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POLLPOS operand must be included in each DFHTCT TYPE=TERHINAL 
specification associated with the line. For TRMTYPE=2980 and 
TRMTYPE=3270, GENP01L=YES is a default specification. 

POOLCNT: Applicable only to the CICS/OS system, this operand is used 
to specify the number of Terminal Control Table line entries (TCTLE's) 
to be included in the pool of TCTLE's for a line group comprised of 
local 3270 Information Display Systems. The pool of TCTLE's is used 
by CICS to support concurrent operations on the BTAM local line group. 

The number of TCTLE's specified should reflect the expected activity 
on the local line group and the anticipated maximum number of concurrent 
requests. For a local line group containing printers, the number 
specified should be the actual number of printers plus one to avoid 
locking out any screen keyboards when all printers are busy. 

When a READ or WRITE for a particular 3270 is issued, CICS allocates 
the first available TCTLE from the pool. This TCTLE is freed when the 
operation at the device is complete. For WRITE operations at a printer, 
the operation at the device is considered complete when the printing 
operation is complete. 

CICS supports as many concurrent operations on the line group as 
there are TCTLE's in the pool. If no TCTLE is available to support a 
requested operation, the request remains pending until a TCTLE becomes 
available. 

For CICS/OS, local 3270 's can be arranged in line groups in any 
desired manner. 

TCTUAL: This operand is used to specify the length, in bytes (0-255) , 
of the Process Control Information field (PCI) for all terminal entries 
(TCTTE's) associated with this line. The default is TCTUAL=0. 

If fields of different (variable) lengths are desired, the TCTUAL 
value can be specified in one or more DFHTCT TYPE=TERMINAL macro 
instructions for terminals associated with this line. In any case, 
the PCI field is generated for each terminal after the last terminal 
entry of the last line. The address of the PCI field is located at 
TCTTECIA; the length is located at TCTTECIL. 

For CICS/OS, PCI fields of fixed length (15 bytes) and/or variable 
length (0-255 bytes) can be specified via the TCTUA operand of the 
DFHSG TYPE=INITIAL macro instruction. In the case of a fixed-length 
PCI field (the address of which is located at TCTTECI) , the TCTUAL 
operand need not be specified. In the case of a variable-length PCI 
field (the address of which is located at TCTTECIA) , the TCTUAL operand 
should be specified in the DFHTCT TYPE=LINE macro instruction and/or 
DFHTCT TYPE=TERHINAL macro instruction. 

OUTQ: Required in all TCAM input process queue Terminal Control Table 
line entries (TCTLE's), the symbolic name identifies the corresponding 
TCAM output process queue TCTLE. Multiple input process queues may 
reference the same output process queue. 

POOL: By specifying POOL=YES on the TCAM output process queue, the 
POOL feature is supported for that TCAM line. The user should analyze 
the restrictions prior to specifying the POOL feature. For further 
information concerning line pool restrictions, see the section 
"CICS/TCAM Interface Considerations". 
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QUEUEID: This optional operand is used to specify a unique user 
identification for the TCAM process queue. The identification is an 
unframed, one-byte hexadecimal number (00-FF) which is placed in both 
the input and output line entry at TCTLEQID to provide unique queue 
identification while executinq a user exit. 

DESCRIBE TERMINAL TYPES 

The types of terminals on the system are described to CICS by the 

symbol DFHTCT TYPE=TERMINAL 

macro instruction. The expansion of this macro instruction is the 
Terminal Control Table terminal entry (TCTTE) . These terminal 
definitions must immediately follow the correspondinq line entry (DFHTCT 
TYPE=LINE) . The sequential terminals (TRMTYPE=CRLP, DISK, TAPE) support 
only one entry each. 

A DFHTCT TYPE=TERMINAL macro instruction must be coded for each 
terminal on a line. On sinqle dropped and multidropped terminals on 
non-switched lines, the DFHTCT TYPE=TERMINAL macro instruction must 
immediately follow the DFHTCT TYPE=LINE macro instruction. The DFHTCT 
TYPE=TERMINAL macro instruction entries must be contiquous for 
multidropped terminals on non-switched lines and for terminals in a 
terminal pool on switched lines. 

For TCAM, the user must specify a sinqle TCTTE for the input process 
queue line. This may be considered to be a "dummy" TCTTE in that it 
does not relate to any physical terminal. On the output process queue 
line (TCTLE) , the user identifies each terminal to be associated with 
that line set. Therefore, if the user has ten terminals associated 
with a particular TCAM process queue, he must code eleven DFHTCT 
TYPE=TERMINAL macro instructions; one follows the input DFHTCT TYPE=LINE 
macro instruction while the remaininq ten follow the output DFHTCT 
TYPE=LINE macro instruction. 

The followinq operands can be used in the DFHTCT TYPE=TERMINAL macro 
instruction: 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number, * 

TRMMODL=number, character, * 

TRMTYPE=1 030,1 050 , 1053, 1 13 0,2020,2260, L2260 ,2265, * 

2740, 2740/2760, 274 1C, 2741 E, 2770, 27 80, 298 0, * 

3275,3277,L3277,32 84,L32 84,3286,L328 6,3735,7770, * 

SYS/3,SYS/7,S360,CRLP,DASD,TAPE,TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY , BISYNC, AUDIO) , * 

LVUNIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address,narae, * 

TRMSTAT= (TRANSACTION, TRANSCEIVE, RECEIVE, 'OUT OF SERVICE',* 

INPUT) , * 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT,SELCTPEN,AUDALARM,COPY,BUFEXP, * 

DCKYBD,UCTRAN) , * 

P0LLPOS=number, * 

TRANSID=name, * 

STN2980=number, * 

TAB2980=number r * 

TIOAL=number, * 

TCTUAL=number 
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TRMIDNT: Used to supply a unique four-character symbolic identification 
to each terminal. The TRMIDNT parameter and the destination 
identification in the Destination Control Table, when applicable, must 
be the same. The identification supplied will be left justified and 
padded with blanks to four characters if less than four characters are 
supplied. This is necessary as the system always searches for a four 
character match when searching tables. This operand may be omitted if 
POOL=YES is included in the DFHTCT TYPE=LINE specification. 

TRMPRTY: Used to establish terminal priority. This decimal value 
(000-255) is used in establishing the overall transaction processing 
priority. (Transaction processing priority is equal to the sum of the 
terminal priority, transaction priority, and operator priority, not to 
exceed 255.) The default is TRMPRTY=0. 

TRMMODL: Specifies the model number of the terminal associated with 
this communication line. If the device is one of the following, this 
operand must be included in either the DFHTCT TYPE=LINE or DFHTCT 
TYPE=TERMINAL specification: 

1. Component of the 1050 Data Communication System 

2. 2740 Communication Terminal Model 2 

3. Component of the 2980 General Banking Terminal System 

4. Component of the 3270 Information Display System 

5. 2740 Communication Terminal with 2760 Optical Image Unit 

6. 2260 Display Station 

7. 2265 Display Station 

TRMMODL=1 is used to specify the 2980 Teller Station Model 1, 3275 
Display Station Model 1, 3277 Display Station Model 1, 3284 Printer 
Model 1, or 3286 Printer Model 1. TRMM0DL=1 is the default for the 
3270 Information Display System. 

TRMMODL=2 is used to specify the 2740 Communication Terminal Model 
2, 2980 Administrative Station Model 2, 3275 Display Station Model 2, 
3277 Display Station Model 2, 3284 Printer Model 2, or 3286 Printer 
Model 2. 

TRMMODL=4 is used to specify the 2980 Teller Station Model 4. 

TRMMODL=5 is used to specify component polling of the keyboard for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 5 (0B) must be coded in the 
polling list (DFTRMLST) . 

TRMMODL=6 is used to specify component polling of reader 1 for the 
1050 Data Communication System using non-switched communication lines. 
Component selection character 6 (0D) must be coded in the polling list 
(DFTRMLST) . 

TRMMODL=7 is used to specify (1) the 2740 Communication Terminal 
with 2760 Optical Image Unit, or (2) component polling of reader 2 for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 7 (0E) must be coded in the 
polling list (DFTRMLST) . 

TRMMODL=0 is used to specify an input component for the 1050 Data 
Communication System. Common polling character (15) must be coded 
in the polling list (DFTRMLST) . TRMMODL=0 is the default specification 
for a 1050 Data Communication System. 
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The TRMMODL=character operand is used to specify the applicable 
screen format for a 2260/2265 Display Station as follows: 

SPECIFICATION SCREEN FORMAT 

TRMMODL=A 6x40 2260 

TRMMODL=B 12x40 2260 

TRMMODL=C 12x80 2260 

TRMMODL=D 15x64 2265 

TRMMODL=E 12x80 2265 

For example, TRMMODL=A specifies a 2260 Display Station with a 6x40 
screen format. 

TRMTYPE: This operand is used to specify the terminal type if (1) the 
terminal type has not already been specified in the DFHTCT TYPE=LINE 
macro instruction, or (2) the user wishes to override the TRMTYPE 
specification in the DFHTCT TYPE=LINE macro instruction. 

CRLP is the card reader and line printer (a pair of sequential 
devices simulating a terminal) . DASD is the direct access device. 
TAPE is the magnetic tape device. A 1053 is a 1053 printer on a local 
or remote 2848 control unit. TWX is the Common Carrier Teletypewriter 
Exchange Terminal Station (Model 33/35) . U/R is a general term that 
refers to any reader, printer, or punch. 

CLASS: This operand is used to indicate the device classification 
associated with a particular line. The applicable keyword parameters 
are: 

Device with conversational type application 

Data collection type device 

Device with cathode ray tube 

Start/stop hard-copy device 

Binary synchronous device 

Audio response device 

LVUNIT: This operand is applicable only when TRMTYPE=L2260, 
TRMTYPE=L3277, TRMTYPE=L3284 f or TRMTYPE=L3286 is specified, or when 
TRMTYPE=1053 is specified for a local 2260 line. LVUNIT specifies a 
decimal number from 1 to N which is used to identify the local video 
unit. The maximum value of N for local 2260 is 25. For local 3270, 
N maximum is 32 (use of Assembler D restricts N to a maximum of 31). 

For the CICS/DOS systems, the LVUNIT specification indicates the 
local video unit's relative position in the corresponding DFHTCT 
TYPE=SDSCI, LINELST=parameter specification. For the CICS/OS system, 
the LVUNIT specification indicates the local video unit' s relative 
position in the concatenation of data definition (DD) statements for 
the corresponding DFHTCT TYPE=SDSCI specification. 

LASTTRM: This operand is used to indicate a "last terminal" condition. 
The applicable keyword parameters are: 

1. GACB, used for GAM only, identifies both the last terminal entry 
on a given line entry and the last terminal entry on a graphics 
attention control block. 

2. LINE, used for BTAM non-switched line processing (except local 
3270) , BGAM (if GACB conditions do not apply) , and TCAM (if 
POOL=YES has not been specified) . 
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1. 


CONV 


2. 


BATCH 


3. 


VIDEO 


4. 


HARDCOPY 


5. 


BISYNC 


6. 


AUDIO 



3. PCOL, used for ETAM switched-line processing, for the local 3270 
Information Display System, and for TCAM, identifies the last 
terminal in the pool. For TCAM, ECOL is used if ECOL=YES has 
been specified. 

TRMADDR: The TRMADDR=address operand specifies the device address 
associated with a given terminal and is reguired only for BTAM devices. 
(This operand is not reguired for some BTAM output devices; for example, 
a dial-up 2741.) For most non-switched lines, the hexadecimal addressing 
characters associated with the terminal must be specified. (This 
operand should not be used if the devices are local 2260's or local 
3270 f s). For either binary synchronous devices or switched lines, the 
label of the BTAM DFTRMLST must be specified using the TRMADDR=name 
operand. 

Note: For a 3735, the BTAM DFTRMLST must be of the SWLST,AD type. For 
a TWX, TRMADDR is not reguired if ANSWRBK=TERMINAL is specified 
on the DFETCT TYPE=LINE macro instruction. 

1RMSTAT: Specifies the type of activity that may occur at a given 
terminal. This terminal status is initially set in the TCTTE and is 
a combination of the processing status and the service status. Possible 
status designations are TRANSACTION, TRANSCEIVE, RECEIVE, INPUT and/or 
•OUT OF SERVICE' . 

A terminal with TRANSACTION status is used in the processing of 
transactions such as inguiries or order entries. A display station is 
normally classified as a TBANSACTION terminal. A hard-copy terminal 
to which no messages are sent without a terminal reguest and through 
which transactions are entered is a TRANSACTION terminal. If no other 
status designation is made, the terminal status defaults to TRANSACTION. 

A terminal with TBANSCEIVE status is a TRANSACTION terminal but one 
to which messages are sent automatically by the user. The automatic 
transaction initiation created by a transient data destination reaching 
a trigger level sets a condition in an appropriate Terminal Control 
Table terminal entry. If the terminal status is TRANSCEIVE and if 
there is no transaction at the terminal, Terminal Control initiates 
the user-defined task. This task is expected to send messages to the 
terminal. 

A terminal with RECEIVE status is one to which messages are sent 
but from which no input is allowed. An example of this type of terminal 
is one which is located in a remote location, such as a warehouse, is 
unattended, but may receive messages. 

Note: RECEIVE should be specified for a System/7 with the Station 

Control feature. This allows polling to be suspended until the 
System/7 is IPL'd by the host, at which time the status is 
changed to TRANSCEIVE. If the System/7 is IPL'd remotely, the 
master terminal must be used to change the terminal status to 
enable the System/7 to transmit. 

A terminal with INPUT status is one which can send messages to CICS 
tut cannot receive messages from CICS. 

Note: System messages may be routed to input terminals under certain 
conditions (e.g., Invalid Transaction Identification, ATP batch 
count) causing DFHTACP to be scheduled. For this reason, the 
user should code a Terminal Error Program (DFHTEP) to perform 
any user-required action. See DFHTEP Programming Considerations. 
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A terminal with an •OUT OP SERVICE" designation is one which can 
neither receive messages nor transmit input. Such terminals are not 
polled by CICS. The 'OUT OF SERVICE 1 parameter can be used in 
combination with TRANSACTION, TRANSCEIVE, or RECEIVE; if such a 
combination is net specified, the terminal status defaults to 
TRANSACTION. 

All terminals except the master terminal can be designated as 'OOT 
OF SERVICE 1 . When appropriate, the terminals can be placed IN SERVICE 
by the master terminal and polling is resumed. 

COMPAT: This operand is used to indicate that the 2260/2265 terminal 
or 1053 printer specified in the "device type" parameter is to be 
simulated on the 3270 Information Display System. The keyword 
parameters are positional and must be replaced by a comma if they are 
emitted. The default is COMPAT=NO. 

The "number of characters" parameter is used to specify the screen 
size of the 2260/2265 terminal. Applicable parameters are 240, 480, 
and 960. 

The "number of lines" parameter is used to indicate the number of 
lines applicable to the 2260/2265 terminal or to insert new line (NL) 
symbols into the 328M/3286 printer output data stream where NL symbols 
are not provided by the user in the output data stream. Applicable 
parameter values are 6, 12, and 15. The default value for a 
960-character screen is 12. 

The "device type" parameter is used to specify either a 1053, 2260, 
L2260, or 2265 terminal. The default is 2260. Note that the 
specification COMPAT= (960, 15) results in an error condition since the 
2260 (assumed by default) cannot support 15 lines. 

The "model number" parameter is used to specify a model number for 
the 2260 terminal being simulated. This parameter provides an interface 
for any user-written application programs that currently test the 
TCTTEMN field before building device-dependent 2260 data streams. 

For further information concerning the use of the COMPAT operand, 
see the section "2260 Compatibility for the 3270". 

FEATURE: This operand is used to specify applicable features for the 
3270 Information Display System and corresponding 3284 Printer Model 
3 on the 3275 Display Station. 

FEATUBE=PTRADAPT specifies the Printer Adapter feature and 
corresponding 3284 Printer Model 3 on the 3275 Display Station. Note 
that a separate DFHTCT TYPE=TERMINAL macro instruction cannot be coded 
for the 3284 Printer Model 3 because the 3284 Model 3 shares the buffer 
of the 3275 Display Station. 

FEATDRE=SELCTPEN specifies the Selector Pen feature for a 3275 
Display Station or a 3277 Display Station. 

FEATURE=AUDALARM specifies the Audible Alarm feature for a 3275 
Display Station or a 3277 Display Station. 

FEATDRE=COPY specifies the Copy feature for a 3277 Display Station, 
3284 Printer, or 3286 Printer attached to a 3271 Control Unit. 

FEATURI=BUFEXP specifies the Buffer Expansion feature (RPQ835503) 
for the 2980 General Banking Terminal System. Applicable only to the 
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first terminal entry of a control group, the BUFEXP parameter increases 
the station buffer size to 96 characters. 

FEATURE=DCKYBD specifies the typewriter keyboard and/or operator 
ccnsole keyboard for a 3275 Display Station or a 3277 Display Station. 
Both uppercase and lowercase data can be transmitted with either of 
these keyboards. 

•FEATURE=UCTRAN specifies translation of all lowercase data to 
uppercase. If FEATURE=UCTRAN is specified, the EBCDIC and/or ASCII 
parameter must be specified through the UCTRAN operand of the DFHSG 
EROGRAM=TCP macro instruction. 

For further information concerning the use of the FEATURE operand, 
see the section "2260 Compatibility for the 3270". 

PCLLPCS: This operand is used to specify, as a decimal integer, the 
position (relative to 1) of the polling characters associated with this 
terminal in the DFTRHLST supplied for the line. If GENPCLL=YES is 
specified (or implied by default) for the line entry, POLLPOS=1 is 
specified for each terminal entry associated with control unit 1, 
POLLPOS=2 is specified for each terminal entry associated with control 
unit 2, etc. 

TRANSID: The TRANSID operand is used to specify a four-character 
transaction code whose use is dependent upon the terminal type for 
which it has been specified. If the access method being used is TCAM, 
the TRANSID operand is applicable only to Terminal Control Table 
terminal entries associated with the TCAM output gueue. 

For the 2740 Communication Terminal/2760 Optical Image Unit 
combination (TRMTYPE=2740,TRMMODL=7) , the TRANSID operand is used to 
specify the transaction code of the transaction that is to be initiated 
when input is received from the 2760 and there is no active task. If 
input is received from the 2740, the first four characters of the input 
data stream are used as the transaction code. 

For the 3735 Programmable Buffered Terminal, the TRANSID operand is 
used to specify the transaction cede of the transaction that is to be 
initiated , for a batch transmission initiated by the terminal operator. 
If an inguiry message is received from the 3735, the transaction code 
used consists of the first four characters following the inguiry header 
(NULL I NULL) . See Appendix G for an example of a user-written 3735 
transaction. 

For all other terminals, the TRANSID operand is used to specify the 
transaction code of a transaction that is to be initiated each time 
input is received from the terminal and there is no active task. If 
the TRANSID operand is omitted, the first four characters of the data 
passed in the TIOA, or, in the case of a formatted 3270 data stream, 
the four characters following the first Set Buffer Address (SBA) order 
seguence, are used as the transaction code unless a TRANSID 
specification has been made in a DFHPC TYPE=RETURN reguest issued by 
the previous transaction. The transaction code used is the one supplied 
by the last specification of the TRANSID operand in the DFHPC macro 
instruction. 

The TRANSID operand is reguired for the following terminals. 

1. 1030 Badge Rea'der 

2. 2740 communication Terminal/2760 Optical Image Unit 
combination 
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3. 3735 "Programmable Buffered Terminal if batched input processing 
is reguired 

STN2980: This operand is used to specify the station for which the 
alternate station address and normal station address are to be generated 
for each terminal entry in the Terminal Control Table corresponding to 
a 2980 General Banking Terminal System. In response to a given STN2980 
specification, an appropriate (hexadecimal) alternate station address 
and normal station address are generated by CICS as follows: 



NORMAL 


ALTERNATE 


STATION 


UO 


FU 





F1 


F5 


1 


F2 


F6 
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F3 


F7 


3 


F8 


34 


4 


5C 


E4 


5 


61 


E5 


6 


E2 


E6 


7 


E3 


E7 


8 


E8 


24 


9 



For example, for normal station address X'40 1 , the user specifies 
STN2980=0 and the alternate station address X , F4" is generated. 

TAB2980: This operand is used to specify, as a single-digit hexadecimal 
value (0-F) , the number of tabs to the passbook area as defined by the 
user and physically (uniguely) set on the terminal. The default is 
TAB2980=0. 

TIOAL: Applicable only to terminals on binary synchronous lines, this 
operand is used to specify the minimum size of the Terminal Input/Output 
Area (TIOA) to be passed to a transaction by the Terminal Control 
program. If the size of an input message exceeds the value specified 
in this operand, the size of the TIOA corresponds to the size of the 
message. 

Note : The minumum size TIOA passed to a transaction which is running 
under control of 2260 Compatibility is governed by the CMPT60L 
operand in the generation of the Terminal Control program. 

TCTUAL: This operand is used to specify the length, in bytes (0-255) , 
of the Process Control Information field (PCI) for this terminal. The 
default is the TCTUAL value specified in the DFHTCT TYPE=LINE macro 
instruction; if not specified in the DFHTCT TYPE=LINE macro instruction, 
the default is TCTDAL=0. 

DEFINE DIGITAL RESPONSE MESSAGES FOR 7770 AUDIO RESPONSE UNIT 

For CICS to communicate with an audio terminal (for example, the 
2721 Portable Audio Terminal) , two digital response messages (an error 
message and a ready message) must be defined in the Terminal Control 
Table for each line. This is accomplished by issuing the 

symbol DFHTCT TYPE=7770MSG, * 

MESSAGE=» message' 

macro instruction, which must immediately precede the DFHTCT TYPE=FINAL 
macro instruction. To avoid confusion, these messages should be unique; 
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that is, these messages should not also be defined in user-written 
application programs. 

The ready message is used by CICS: 

1. In response to a valid Terninal Identification being entered 
subseguent to line connection. 

2. When the sign-on seguence has been completed. 

3. When a 7770 Audio Response Unit is connected to a line and no 
transaction is associated with the 7770. 

4. In response to a READ reguest if the reguest seguence was not 
a WRITE, READ. 

The error message is used by CICS: 

1. In response to an invalid Terminal Identification being entered 
subseguent to line connection. 

2. When a valid Terminal Identification has been entered but (1) 
the terminal has an "out of service" status, or (2) the terminal 
has an "in service" status but the Terminal Identification has 
already been entered on another line. 

3. In response to an invalid Transaction Identification. 

4. In response to an error during the sign-cn/sign-of f seguence. 

5. If the input message is tco long. 

6. If the transaction associated with the 7770 is abnormally 
terminated. 

7. If a 32-second timeout occurs, or if a five-second time out 
occurs while entering information reguired by CICS. 

MESSAGE: This operand is used to define digital response messages for 
the 7770 Audio Response Unit. These messages must be constructed in 
the form of hexadecimal constants, enclosed within single guotes, and 
may contain up to 48 hexadecimal digits (24 bytes) . The first two 
digits must contain binary zeros (00) to represent a one-byte "silence" 
track address on the 7770; subseguent digits may be used to represent 
up to 23 additional one-byte 7770 track addresses. For further details, 
see the publication Component Description 7770 Audio Response Unit 
Model 3 (GA27-2712) . 

See Appendix B for an example of a typical digital response 
specification. 

SPECIFY END OF TERMINAL CONTROL TABLE 

The end of the Terminal Control Table is indicated to the control 
system by the 

DFHTCT TYPE=FINAL 

macro instruction, which must be contained on the last control card 
for the Terminal Control Table assembly. An Assembler END card that 
includes the label DFHTCTEA must be provided by the user to end the 
assembly. 
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TERMINAL CONTROL TABIE EXAMPLE 

Figure 2 illustrates the coding that is reguired to create a CICS 
Terminal Control Table. The terminal network described includes: 

1. One DASD seguential terminal 

2. Two 2260 Display Stations and one 1053 printer (local attachment) 

3. Two 27U0 Telecommunication terminals with the Station Control 
feature 

4. Two 1050 Data Communication terminals (dial-up) 

Note: DFTRMLST macro definitions are reguired by BTAM devices. These 
entries should be coded immmediately preceding DFHTCT TYPE=LINE 
entries or immediately following DFHTCT TYPE=TERMINAL entries. 

To be applicable to CICS/OS, or if converting from CICS/DOS to 
CICS/OS, the following changes must be made to Figure 2: 

• The EDNAME operand must be included unless the name specified in 
the ESCNAME operand is an acceptable default. 

• The MODE, MACRF and NCP operands must be included unless the 
respective default values for these operands are acceptable. 

• The FLNNAME operand must be included to specify the name of the 
first communication line entry defined by the DFHTCT TYPE=LINE 
macro instruction. 

If converting from CICS/DOS to CICS/OS, operands applicable only to 
CICS/DOS need not be removed, since they are ignored by CICS/OS. 

For other examples of Terminal Control Table preparation, see 
Appendix B. 
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DFHTCT 
DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



TYPE=INITIAL 

TYPE=SDSCI, 

DEVADDR=SYS001, 

DEVICE=2314, 

DSCNAME=DISKIN1 

TYPE=SDSCI, 

DEVADDR=SYS006, 

DEVICE=2314, 

DSCNAME=DISK0T1 

TYPE=LINE, 

ACCMETH=SEQUENTIAL, 

TRMTYPE=DASD, 

ISADSCN=DISKIN1, 

0SADSCN=DISK0T1, 

INAREAL=80 

TYPE=TERMINAL, 

TRMIDNT=SAMB, 

TRMPRTY=11 , 

TRMSTAT=TRANSCEIVE 

TYPE=SDSCI, 

CU=28U8, 

DEVICE=L2260, 

LINELST= (037,038,039) , 

SWITCH=NO, 

DSCNAME=DTF60L 

TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=L2260, 

DSCNAME=DTF60L, 

INAREAL=960 

TYPE=TERMINAL, 

TRMIDNT=L60A, 

TRMPRTY=64, 

LVUNIT=1 

TYPE=TERMINAL, 

TRMIDNT=GAMB, 

TRMPRTY=63, 

LVUNIT=2 

TYPE=TERHINAL, 

TRMIDNT=L600, 

TRMTYPE=1053, 

LVUNIT=3, 

TRMPRTY=32, 

TRMSTAT=RECEIVE, 

LASTTRM=LINE 

TYPE=SDSCI, 

CU=2703, 

DEVICE=2740, 

FEATURE= (STC,CHK) , 

LINELST=(027) , 

SWITCH=N0, 

DSCNAME=DTF40MD 



START OF TCT 

SPECIFY DATA SET CONTROL 

INFORMATION 



SPECIFY DATA SET CONTROL 
INFORMATION 



DASD LINE ENTRY 



DASD TERMINAL ENTRY 
DASD SYMBOLIC NAME 



SPECIFY DATA SET CONTROL 
INFORMATION 



LOCAL 2260 LINE ENTRY 



2260 TERMINAL ENTRY 

2260 SYMBOLIC NAME 

FIRST UNIT ON A DTF 

2260 TERMINAL ENTRY 

2260 SYMBOLIC NAME 

SECOND UNIT ON A DTF 

1053 TERMINAL ENTRY 



THIRD UNIT ON A DTF 



SPECIFY DATA SET CONTROL 
INFORMATION 



Figure 2 (Part 1 of 2) . Coding for terminal control table 
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PL2740L1 DFTRMLST OPENLST , (46 , 45) 
DFHTCT TYPE=LINE, 

ACCMETH=,BTAM, 

TRMTYPE=2740, 

TRMMODL=1, 

DSCNAME=DTF40MD, 

BTAMRLN=1, 

LISTADR=PL2740L1, 

INAREAL=240, 

FEATURE= (SCONTROL, CHECKING) 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=T41L, 

TRMADDR=46, 

TRMPRTY=127, 

TRMSTAT=TRANSCEIVE 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=T41K, 

TRMADDR=45, 

TRMPRTY=128, 

TRMSTAT=TRANSCEIVE, 

LASTTRM=LINE 
DFHTCT TYPE=SDSCI r 

CU=2703, 

DEVICE=1050, 

LINELST=(031) , 

SWITCH=YES r 

DSCNAME=DTF1050 
IDL1050 DFTRMLST DIALST, , (62 15,6 41 5) 
DIL1050A DFTRMLST DIALST, 7 , 12 39876, (62 13) 
DIL1050B DFTRMLST DIALST, 7, 1 239875, (64 1 3) 



POLL LIST TERMINAL 
2740 LINE ENTRY 



POLL LIST NAME 



2740 TERMINAL ENTRY 
2740 SYMBOLIC NAME 
TERMINAL ADDRESS = L 



2740 TERMINAL ENTRY 
2740 SYMBOLIC NAME 
TERMINAL ADDRESS = K 



LAST TERMINAL ON LINE 
SPECIFY DATA SET CONTROL 
INFORMATION 



DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=1050, 

DSCNAME=DTF1050, 

INAREAL=80, 

BTAMRLN=1, 

LISTADR=IDL1050, 



1050 LINE ENTRY 



POLL LIST NAME 



T50POOL 



FEATURE=(AUTOANSR, AUTOCALL) , 

POOLADR=T50POOL, 

ANSWRBK=TERMINAL 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=T50A, 

TRMADDR=DIL1050A, 

TRMPRTY=203, 

TRMSTAT=TRANSCEIVE 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=T50B, 

TRMADDR=DIL1050B, 

TRMPRTY=204, 

TRMSTAT=TRANSCEIVE, 

LASTTRM=POOL 
DFHTCT TYPE=FINAL 
END DFHTCTBA 



1050 TERMINAL ENTRY 



1050 TERMINAL ENTRY 



LAST TERMINAL ON LINE 

END OF TCT 

POINT TO REQUIRED ENTRY LABEL 



Figure 2 (Part 2 of 2) . Coding for terminal control table 



FIL E CONTROL TABLE (FCT) 

The File Control Table is used to describe to CICS any user data 
sets (files) that are processed by file management. (Note that 
seguential data sets should be defined as extrapartition destinations 
using the DFHDCT macro.) The DFHFCT macro instruction is used to 
generate entries in the table and to reguest the following services: 
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1. Set up the open list for the data sets to be used when 
initializing and terminating the system. 

2. Describe characteristics of the data sets, such as access method 
used, record characteristics, types of service allowed. 

3. Define use of the data set as a cross index and provide the 
information to locate the next data set via indirect access. 

4. Define the segments and segment sets of a record. 

The data control information for each data set is included in the 
DFHFCT macro instruction. The indirect access and segmenting services 
are mutually exclusive; the entry for one data set cannot specify both 
services. 

The following operands can be included in the DFHFCT macro 
instruction: 

DFHFCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM,ISAM,DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NE WREC ,INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSIZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 

NRECDS=number, * 

IOSIZE=number, * 

IOWORK=symbolic name, * 

DEVICE= (n r m) , * 

SRCHM=YES, number, * 

VERIFY=YES, * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM= (format, characteristic, DCB record format), * 

OPEN=INITIAL, DEFERRED, * 
KEYLEN=length 

DFHFCT TYPE=INDACC, * 

OBJDSID=name, * 

IARLKP=number, * 

IALKFL=length, * 

IADADMI=RELREC,KEY, * 

IADIII=hexadecimal character, * 
DUPDSID=name 

DFHFCT TYPE=SEGHEAD, * 

SEGLENG=length, * 

INDDISP=number, * 
TSEGIND=BIT, DISPLACEMENT 

DFHFCT TYPE=SEGDEF, * 

SEGNAME=name, * 

SEGCHAR= (format, alignment) , * 
SEGLENG=length 
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DFHFCT TYPE=SEGSET, * 

SEGSET=name, * 

SEGNAME= (namel ,. . . ,nameN) 

DFHFCT TYPE=SEGLAST 

DFHFCT TYPE=FINAL 

DFHFCT TYPE=LOGICMOD 

ESTABLISH CONTROL SECTION FOR FILE CONTROL TABLE 

The control section into which the File Control Table is assembled 
is established by means of the 

DFHFCT TYPE=INITIAL, * 

SUFFIX=xx 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the File Control Table. 

SUFFIX: This operand specifies a two-character alphameric suffix (other 
than 'NO' which is reserved) for the File Control Table being assembled. 
This suffix, if specified, is appended to the standard module name 
(DFHFCT) and is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 

DESCRIBE DATA SET FOR FILE MANAGEMENT 

The physical characteristics of a data set are described to CICS 
File Management by the 

DFHFCT TYPE=DATASET 

macro instruction. This macro instruction includes operands that 

provide information about the access method, record characteristics, 

and the types of service allowed for the data set. This information 

is used to generate a DTF for CICS/DOS or a DCB for CICS/OS. 

If the DL/I facility of the IBM Information Management System 
(IMS/360) is to be accessed under CICS/OS, the DFHFCT TYPE=DATASET 

macro instruction is used to provide information about Data Language/I 
(DL/I) data bases. In this case, DATASET and ACCMETH are the only 

operands reguired. Physical characteristics of the DL/I data bases 

need not be specified since they are specified during generation of 

IMS Data Base Descriptions (DBD's). 

The DFHFCT TYPE=DATASET macro instruction can include the following 
operands: 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM, ISAM, DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NE WREC ,INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSIZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 
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NRECDS=number, * 

IOSIZE=number, * 

IOWORK=syrabolic name, * 

DEVICE= (n,m) , * 

SRCHM=YES,number, * 

VEEIFY=YES / * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM= (format, characteristic, BCB record format), * 

OFEN=INITIAL, DEFERRED, * 
KEYLEN=length 

DATASET: Specifies the synbclic data set name tc be used as the File 
Control Table entry for a specific data set. This data set name can 
consist cf from one to seven characters in the CICS/DOS systems or from 
one to eight characters in the CICS/OS system. Since this data set 
name is used when generating the operating system control block 
(DCB/DTF) , it must be the same as the DOS file name or the OS DDNAME 
used in the job control statement defining the data set. 

For a DL/I data base the DATASET operand must specify the same data 
base name as was specified in the Program Communication Block (PCB) 
statements of Program Specification Block (PSB) generation (PSBGEN) . 

ACCHETH: Specifies the method of organization for a specific data set. 
ACCMETH=TSAM, ACCHET H=BDAM , or ACCMETH=DL/I must be specified. 

SEBVEEQ: Used to define the types of service reguest that can be 
processed against the data set. The parameters that can be included 
are as fellows: 

Records on this data set may be read. 

Eecords may be written on this data set. 

Records may be updated on this data set. DPDATE reguires 

that GET and PUT also be specified. 

Records may be added to the data set. NEWREC requires 

that PUT also be specified. NEWREC must be specified 

for OS ISAM data sets with variable-length records if 

updating is to be performed. 

5. INEACC Data set is used as a cross index. If INEACC is 

specified, the DFHFCT TYPE=INEACC macro instruction must 
be coded immediately following this DATASET definition. 

6. SEGMENT Records are segmented. If SEGMENT is specified, the 

DFHFCT TYPE=SEGHEAD, DFHFCT TYPE=SEGDEF, DFHFCT 
TYPE=SEGSET, and DFHFCT TYPE=SEGLAST macro instructions 
must be coded immediately following this DATASET 
definition. 

7. BROWSE Records may be seguentially retrieved from the data set. 

When BROUSE is specified, DFHFCT TYPE=LOGICMOD must also 
be specified. 

8. KEY Records are to be retrieved by key from DAM data set. 

This parameter should be specified only if ACCMETH=BDAM. 

9. NCEXCTL Records are net tc be placed under exclusive control 

when a read for update is reguested. Unless this 
parameter is specified, a read-for-update will cause 
the record to be placed under exclusive control (within 
the CICS partition/region) . 

lo;te_: INEACC and SEGMENT cannot both be coded for the same data set. 
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1. 


GET 


2. 


PUT 


3. 


UPDATE 


4. 


NEWREC 



A data set used as a cross-index data set may not be defined as 
blocked BEAM. 

EIKKEYL: Specifies a decimal value from 1-255 which represents the 
physical key length for a direct access record. This operand must 
always be specified for ISAM data sets and DAM data sets with physical 
keys. If a DAM data set contains blocked records, and deblocking is 
to be performed by using a logical key (that is, a key embedded within 
each logical record) , the logical key length is specified by using the 
KEYLEN operand. If records are to be placed under exclusive control 
during update operations, the physical key may not exceed 225 bytes. 

EXTENT: Applicable only to the CICS/DOS systems, this operand 
represents the maximun number of extents that are specified for a data 
set. This operand is required if ACCMETH=ISAM. EXTENT=2 represents 
a minimum value (one for prime data area and one for cylinder index) . 
If ACCMETH=BDAM, the presence of the EXTENT operand indicates that 
relative addressing (as opposed to actual addressing) is being used 
and the EELTYPE cperand must also be used. 

CYLOFI: Applicable only to the CICS/DOS systems, this operand is 
required only if ACCMETH=ISAM. It is used to specify the number of 
tracks per cylinder which are reserved for cylinder overflow records. 

INDAEEA: This operand is applicable only if ACCMETH=ISAM and specifies 
the unique symbolic came which is used by the DFHFCT macro to 
automatically qenerate a main storage area (within the File Control 
Table) that will contain all or part of the cylinder index. This 
operand is required only if the cylinder index is to be processed in 
main storage. 

INDSIZE: This operand specifies the length (in bytes) of the cylinder 
index area specified in the INDAREA operand. The minimum number of 
bytes can be calculated as: 

(m+3) (keylength + 6) 

where "m" is the number of entries to be read into main storage at one 
time, 3 is the number of dummy entries, and 6 is an abbreviated pointer 
to the cylinder. If m is set to the number of prime data cylinders + 
1, all of the cylinder index is read into main storage at one time. 
This operand is applicable only if ACCMETH=ISAM and the INDAEEA operand 
is specified. 

INDSKIP: Applicable only to the CICS/DOS systems, the INDSKIP=YES 
operand indicates that the index skip feature is to be used if index 
entries reside in main storage. This operand is applicable only if 
ACCMETH=ISAM and the INDAHEA operand are specified. 

MSTIND: Applicable only to the CICS/DOS systems, the MSTIND=YES operand 
indicates that a master index exists for the ISAM data set. This 
operand is applicable only if ACCMETH=ISAM and should be specified only 
if a master index exists for the data set 1 . 

NRECDS: This operand specifies the number of logical records in a 
block, and is called the blocking factor. This operand is applicable 
only to the CICS/DOS systems and only if ACCMETH=ISAM, and should be 
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specified only if the records are blocked. For DOS ISAM data sets with 
variable-length records within fixed-length blocks, this number has no 
relation to the actual number of records within the block. However, 
the number specified multiplied by the LRECL parameter must equal the 
actual block size en the data set. 

IOSIZE: This operand specifies the number of bytes in the main storage 
area used when acding records to an ISAM data set. This operand should 
be used only when SEBVREQ=NEw"REC is also specified. For CICS/DOS 
systems, this operand causes a static work area to be generated as part 
of the FCT entry for the data set being defined. For the CICS/OS 
system, the IOWOBK operand must also be used to supply a symbolic name 
tc be associated with the work area. For further details, refer to 
DTFIS generation in the publication, DOS Supervisor and I/O M ac ros 
(GC24-5037) or ISAM data set processing in the publication, OS Data 
Ma^a^ejment Services (GC 26-3746) . 

Note: Under CICS/DOS with multiple ISAM files, whenever NEWREC services 
are requested and some files specify IOSIZE while ethers do not, 
two ISAM logic modules will be link-edited into the system. To 
prevent this, specify IOSIZE for all ISAM files requesting NEWREC 
services. 

IOWORK: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the symbolic name of a main storage work area to be 
used by the access method when adding records to ISAM data sets. If 
the data set contains variable-length records, this operand must be 
specified. 

It is permissible for the same symbolic name to be specified in more 
than one data set definition, thus causing an area to be shared. CICS 
prevents the shared area from being used concurrently by more than one 
transaction. 

A static work area is generated within the FCT for each unique 
symbolic name encountered during FCT generation. The size of each area 
is equal to the largest IOSIZE specified for each symbolic name. 

DEVICE: Applicable only to the CICS/DOS systems, the DEVICE=(n,m) 
operand is used for both DAM and ISAM data sets. "n" and "ra" specify 
2311, 2314, 2321, or 3330. For DAM, "n" specifies the device type on 
which the data set resides. ("ra" dees not apply to DAM.) For ISAM, 
"n" specifies the device type on which the prime data area (and overflow 
area if present) reside. For ISAM, "m" specifies the device type 
containing the high-level index. If this operand is omitted, the 
default is DEVICE= (2314 ,2314) . 

SRCHM: This operand is applicable only to DAM keyed data sets and 
provides for a multiple track search for keyed records. If this operand 
is omitted, multiple track search does not occur. 

For CICS/DOS systems, SRCHM=YES is the only allowable form of the 
operand. If fixed-length keyed records are to be added to the file, 
SRCHM=YES must be specified. 

For the CICS/OS system, SRCHM=number is the only applicable form of 
the operand, where "number" represents the number of tracks or blocks 
to be searched. The default is SRCHM=0. 

For further details, see the SRCHM operand under DTFDA generation 
in the publication, DOS Supervisor and I/O Macros (GC24-5037) or BDAM 
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data set processing in the publication, OS Data Management Services 
(GC26-3746) . 

VERIFY: The VERIFY=YES operand indicates that the user wants to check 
the parity of disk records after they are written. If this operand is 
omitted, records are not verified after a write reguest. 

RELTYPE: This operand applies only to EAM data sets and specifies that 
relative addressing is being used in the block reference portion of 
the Record Identification field. If the RELTYPE operand is omitted, 
absolute addressing is assumed (that is, HBBCCHHR) . If RELTYPE=DEC, 
the zoned decimal format is being used. If RELTYPE=HEX, the hexadecimal 
relative track and record format is being used. If RELTYPE=BLK (CICS/OS 
only) , relative block addressing is being used. For further details, 
see "Data Base Considerations" in the CICS Application Programmer's 
Reference Manual (SH20-1047) . 

IRECL: Specifies the maximum length (in bytes) of the logical record. 
For DOS ISAM data sets with variable-length records within fixed-length 
blocks, this number has no relation to the actual length of any logical 
record. However, the number specified, multiplied by the NRECDS 
parameter, must egual the actual block size on the data set. This 
operand must always be specified. 

For CICS/DOS, this operand should contain only one value (parameter) . 
This value should not be enclosed within parentheses. 

If the user of CICS/OS wishes to have a LRECI value generated in 
the DCE, he must specify that value in the second parameter of the 
operand; for example, LRECL= (50, 50) , where the first "50" pertains to 
the FCT and the second "50" pertains to the DCB. If the second 
parameter is not specified, the DCB is generated without a LRECI value. 
If the data set is BEAM organized, the second parameter should never 
be specified. 

NotejL NRECDS=1,LRECL=blocksize, is not allowed. The most advantageous 
specification is NRECDS=2,LRECL= (blocksize/2) . 

BLKSIZE: Specifies the length (in bytes) of the block. If blocks are 
variable-length, the length specified should be the maximum block 
length. If the NEWREC or BROWSE operands are used for DAM fixed-length 
data sets with keys, BLKSIZE must be (LRECL + BLKKEYL) for unblocked 
records or (LRECL * BLOCKING FACTOR + ELKKEYL) for blocked records. 
If blocks are undefined, for CICS/OS the length specified should be 
the maximum block length, for CICS/DOS the length should be the maximum 
block length + 8. This operand must always be specified. 

For CICS/DOS, this operand, should contain only one value (parameter) . 
This value should not be enclosed within parentheses. 

If the user of CICS/OS wishes to have a BLKSIZE value generated in 
the DCE, he must specify that value in the second parameter of the 
operand; for example, BLKSIZE= (250,250) , where the first "250" pertains 
to the FCT and the second "250" pertains to the ECB. If the second 
parameter is not specified, the DCB is generated without a BLKSIZE 
value. The DCB value (second parameter) should always specify the true 
block size while the FCT value (first parameter) may, for DAM data 
sets, include the BLKKEYL value. In no case should the first BLKSIZE 
value specified, be less than the actual blocksize of the data set. 
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RKP: Specifies, the starting position of the key field in the record 
relative to the beginning of the record (position zero for DAM and ISAM 
data sets except position one for DOS ISAM data sets) . With 
variable-length records, this operand must include the four-byte LLbb 
field at the beginning of each logical record. This operand must always 
be specified for data sets that have keys within each logical record 
or when browsing. 

Note: SERVREQ=EROWSE requires embedded keys in the data field in DOS 
ISAM, therefore the RKP parameter is required. In DOS ISAM, if 
records are unblocked, the following MNOTE will be generated in 
the DTFIS: 0,'KEYLOC INVALID, PARAMETER IGNORED'. 

RECFORM: Describes the format and characteristics of records on the 
data set. If this operand is omitted, the default is UNDEFINED. 

For CICS/DOS, if NEWREC is specified for undefined records, BLKSIZE 
must include an additional eight bytes for the count field. 

The fcrmat of the data set is described using one of the following 
parameters: 

1. FIXED Records are fixed length. 

2. VARIABLE Records are variable length. 

3. UNDEFINED Records are of undefined length. 

The characteristic of the data set is specified using one of the 
following parameters: 

1. BLOCKED Records are blocked. 

2. UNBLOCKED Records are not blocked. 

If the user of CICS/OS wishes to have the record format specified 
in the DCB, he must specify that value in the third parameter of the 
operand; for exanple, RECFCRM= (FIXED, BLOCKED, FBS) . If the third 
parameter is not specified, the record format is not specified in the 
DCB. 

Note: For CICS/OS ISAM data sets with BROWSE option specified, a DCB 
RECFM parameter of VB or FB is always generated regardless of 
whether or not the data set is blocked. 

OPEN: The OPEN operand is used to specify the initial status of the 
data set. OPEN=INITIAL causes the data set to be opened by System 
Initialization, while OPEN=DEFERRED will not open the data set until 
the user indicates he wishes it opened by using the Master Terminal 
Open/Close service function or the use of a DFHOC macro instruction in 
an application program. If this operand is omitted, the default is 
CPEN=INITIAL. 

KEYLEN: The KEYLEN operand is used to specify the length of the logical 
key for the deblocking of DAM data sets. This key is usually embedded 
and located through use of the RKP operand. The length of the recorded 
(physical) key for DAM and ISAM data sets is specified in the ELKKEYL 
operand, and may be different from the value specified for KEYLEN. 
This operand must always be specified when logical keys are used. 

DESCRIBE CROSS-INDEX DATA SET RECORD 

The record on a cross-index data set that points to the next data 
set to be read is described using the 
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DFHFCT TYPE=INDACC 

macro instruction. This macro instruction may also contain information 
regarding duplicate records which may be referenced by this index 
record, including a pointer to a duplicate data set which contains 
additional identifying information. If this macro instruction is used, 
the SERVEEQ operand of the DFHFCT TYPE=DA1ASET macro instruction must 
include GET and INDACC. For further information on indirect accessing, 
refer to "Data Base Considerations" in the CICS Application Programmer's 
Reference Manual (SH20-1047) . 

The DFHFCT TYPE=INDACC macro instruction can include the following 
operands: 

DFHFCT TYPE=INEACC, 

OBJDSID=name, * 

IARLKP=number r * 

IALK?L=length, * 

IAEADMI=RELREC,KEY, * 

IAEIII=hexadecimal character, * 

DDPDSID=name 

OBJDSID: Specifies the name of the data set referenced by the 
cross-index data set record. This name can consist cf from one to 
seven characters in the CICS/DOS systems cr from one to eight characters 
in the CICS/OS system. This operand must always be specified. 

IAEIKP: Specifies the relative location within the cross-index data 
set record of the Record Identification field which is to be used to 
access the object data set. The displacement is relative to the 
beginning of the record (position zero). This operand must always be 
specified. 

IAIKFI: Specifies the length (in bytes) of the Record Identification 
field that is to be used to access the object data set. This operand 
must always be specified. 

IAEADMI: Supplies the argument type (RELREC or KEY) for the deblocking 
of a record from a blocked BDAM data set. IADADMI=REIREC signifies 
that the deblocking technique is relative record. IADADMI=KEY signifies 
that the deblocking technique is key. This operand can be used only 
if the data set (file) to which this index data set points is the 
primary (target) data set. If this operand is omitted, and if the data 
set to which this index data set points is a blocked BDAM data set, 
the entire block is returned to the user in the File Control area. 

IADIII: This operand is used to specify a one-byte user-assigned code 
which signifies that the data in the Record Identification field refers 
to a duplicate data set rather than the normal object data set. This 
code must be contained in the first position of the Record 
Identification field and must be different from any other data that 
would normally appear in this position. This operand must always be 
specified if a duplicates data set name is specified (DDPDSID) . 

DDPDSID: This operand is used to specify the identification for the 
duplicate data set associated with the cross-index data set. This 
identification can contain up to seven characters for CICS/DOS and up 
to eight characters for CICS/OS. This operand may be omitted if a 
duplicates data set does not exist. 
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DEFINE HEADER OF SEGMENTED RECORD 

If the records on a data set are segmented, the 

DFHFCT TYPE=SEGHEAD 

macro instruction defines for File Management the header portion (root 
or control segment) of a segmented record. TYPE=SEGHEAD is the first 
of four operands which must be coded to specify segmented records. 

The DFHFCT TYPE=SEGHEAD macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGHEAD, * 

SEGLENG=length, * 

INDDISP=number, * 
TSEGIND=BIT, DISPLACEMENT 

SEGLENG: Specifies the length (in bytes) of the header portion (root 
segment) of the record. This operand must always be specified. 

INDDISP: Provides the displacement of the segment indicator field 
relative to the beginning of the record (position zero) . This operand 
must always be specified. 

TSEGIND: Specifies the type of segment indicator field (BIT or 
DISPLACEMENT) . The default is TSEGIND=BIT. 

DESCRIBE EACH SEGMENT OF A SEGMENTED RECORD 

Each segment of a segmented record is described by means of the 

DFHFCT TYPE=SEGDEF 

macro instruction. TYPE=SEGDEF must be coded for every segment in the 
record in the sequence in which it occurs within the record. Definition 
of the last segment must be followed by the TYPE=SEGLAST operand which 
must precede the coding of the TYPE=SEGSET operands to automatically 
generate SEGSET=ALL as the first segment pattern in the File Control 
Table. 

The DFHFCT TYPE=SEGDEF macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGDEF, * 

SEGNAME=name, * 

SEGCHAR= (format, alignment) , * 
SEGLENG=length 

SEGNAME: Specifies the eight-character symbolic name (label) of the 
segment. This operand must always be specified. 

SEGCHAR: Indicates characteristics (format, alignment) of the segment. 
If the SEGCHAR operand is omitted, the defaults are FIXED format, BYTE 
alignment. If one characteristic is specified, both must be specified. 

The format of a segment is described using one of the following 
parameters: 
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1. FIXED, the segment is fixed length. 

2. VARIABLE, the segment is variable length. The first byte of 
the segment indicates the length of the segment. 

When a segment is brought into main storage, the alignment is 
described using one of the following parameters: 

1. BYTE, the segment has no alignment. 

2. HALF, the segment is halfword aligned. 

3. FULL, the segment is fullword aligned. 

4. DOUBLE, the segment is doubleword aligned. 

SEGLENG: Specifies the length (in bytes) of the segment; up to 255 
bytes can be specified (the length of the largest segment allowed) . 
If the segment is variable length, this value represents the maximum 
length. This operand must always be specified. 

DESCRIBE SEGMENT SETS 

The pattern of segments for a particular data set is described using 
the 

DFHFCT TYPE=SEGSET 

macro instruction. As many segment sets as desired may be specified. 

The DFHFCT TYPE=SEGSET macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGSET, * 

SEGSET=name, * 

SEGNAME= (namel ,. . . ,nameN) 

SEGSET: Specifies the eight-character symbolic name (label) assigned 
to a particular pattern of segments. This label is used in coding the 
DFHFC macro instruction when segment services are required. The label 
may be the same as one of the segment names specified previously in a 
SEGDEF macro instruction but must be different from any other SEGSET 
name specified. The label ALL should not be used since CICS 
automatically creates a universal segment set with this label. This 
operand must always be specified. 

SEGNAME: Specifies the name of each segment to be included in the 
segment set, in the sequence in which the segment occurs in the 
segmented record. SEGNAME must the same name as that specified in a 
previous DFHFCT TYPE=SEGDEF macro instruction. 

SPECIFY LAST SEGMENT SET 

The end of the segment definitions and the end of the segment set 
definitions is indicated by the 

DFHFCT TYPE=SEGLAST 

macro instruction, which must be coded immediately following the last 
macro segment definition (TYPE=SEGDEF) and immediately following the 
last segment set (TYPE=SEGSET) for a data set. This macro instruction 
generates SEGSET=ALL, which includes all the segments in the record, 
as the first entry in the segment set portion of the File Control Table. 
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SPECIFY END OF FILE CONTROL TABLE 

The end of the File Ccntrcl Table is indicated by the 

DFHFCT TYPE=FINAL 

macro instruction, which creates a dummy table entry to signal the 
table end. This macro instruction is the last statement before the 
Assembler END statement, except in the CICS/DOS systems where the user 
may also elect tc code the DFHFCT TYPE=LOGICMOD macro instruction. The 
Assembler END statement must include the label DFHFCTBA. 

CREATE SUPERSET ISAM LOGIC MODULE (CICS/DOS only) 

A superset ISAM logic module can be assembled in the CICS/DOS systems 
by issuing the 

DFHFCT TYPE=LOGICMOD 

macro instruction as the last statement before the Assembler END 
statement. The resulting logic module meets all the processing 
reguirements for defined ISAM data sets with the following exception. 

If multiple ISAM data sets have been defined with the "add" function 
(SERVREC=NEWREC) and some of the data sets have the "prime data in main 
storage" characteristic (IOSIZE=number) while other data sets do not, 
an additional logic module is reguired to support those data sets which 
do not have the "prime data in main storage" characteristic. The user 
can circumvent this situation by ensuring that ISAM data sets with the 
"add" feature are all defined either with or without the "prime data 
in main storage" characteristics (IOSIZE=number) . 

If the user is reguired to assemble an additional ISAM logic module, 
he is so notified in a series of diagnostic messages at the end of the 
File Control Table listing. Also included in these messages are the 
reguired parameter values he must specify to create a superset logic 
module. 

Note: If SERVREQ=BROUSE is specified by any DFHFCT TYPE=DATASET macro 
instruction, then DFHTCT TYPE=LOGICMOD must also be specified 
in that File Control Table. 

For further details ccncerning logic module preparation, see the 
CICS/DOS Operations Guide. 

FILE CCNTEOL TAELE EXAMPLE 

Figure 3 illustrates -the coding that is reguired to create a File 
Control Table for three data sets. The first data set in the table is 
a cross- index data set that provides indirect access to a master data 
set and may reference a duplicate data set. The master data set 
requires segmenting services. 
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DFHFCT TYPE=INITIAL 
DFHFCT TYPE=DATASET, 

EATASET=INDEX, 

ACCMETH=ISAM r 

SERVREQ= (GET, 

PUT, 

UPDATE, 

NEWREC, 

INDAC'C) , 

BECEORM= (FIXED, BLOCKED) , 

IRECl=37 r 

ELKSIZE=370 f 

ELKKEYL=5 



START OF FILE CONTROL TABLE 
TAELE ENTRY FOR AN ISAM 
DATA SET USED AS A CROSS- 
INDEX DATA SET FOR A DATA SET 
NAMED MASTER. 
THIS DATA SET MAY BE 
DPEATED ANE ADDED TO. 



DFHFCT TYPE=INEACC r 

OBJDSID=MASTER, 

IARLKP=26, 

IALKFL=11, 

IADIIT=FF, 
EDPDSID=DDPLICA 
DFHFCT TYPE=DATASET, 

EATASET=DUPLICA, 
ACCMETH=BDAM r 
LRECL=22, 
SERVREQ= (GET) , 
RECFORM= (FIXED r U 
ELKSIZE=22 



THIS DATA SET REF 
A DATA SET NAMED 
WHOSE KEY IS FOUN 
POSITION 26 OF TH 
RECORD. IT IS 11 
IT MAY POINT TO A 
DATA SET NAMED DU 
TAELE ENTRY FOR A 
DUELICATES DATA S 
CONTAINS KEYS TO 
DATA SET. IT IS 
DATA SET. 
NBLOCKED) , 



ERENCES 


* 


MASTER, 


* 


D AT 


* 


IS 


* 


CHARACTERS. 


* 


DUPLICATES 


* 


PLICA. 




EDAM 


* 


ET WHICH 


* 


THE MASTER 


* 


A READ-ONLY 


* 




* 




* 



DFHFCT TYPE=DATASET, 

DATASET=MASTER, 

ACCMETH=ISAM r 

SERVREQ= (GET, 

PUT, 

UPDATE, 

NEWREC, 

SEGMENT) , 

RECFORM= (FIXED, BLOCKED) , 

LRECL=310, 

ELKSIZE=1550, 

RKP=11 r 

ELKKEYL=5 



TAELE ENTRY FOR AN ISAM DATA 
SET WHICH MAY BE UPDATED AND 
AEDED TO, AND WHOSE RECORDS 
ARE SEGMENTED. 



DFHFCT TYPE=SEGHEAD, 

SEGLENG=2, 

INDDISP=2, 

1SEGIND=BIT 
DFHFCT TYPE=SEGDEF, 

SEGNAME=SEGMENT1, 

SEGCHAR= (FIXED, 

EOUBLE) , 

SEGLENG=50 
DFHFCT TYPE=SEGDEF, 

SEGNAME=SEGMENT2, 

SEGCHAR= (VARIABLE, 

HALF) , 

SEGLENG=70 



SEGMENT HEADER DESCRIPTION 



SEGMENT #1 OF THE RECORD IS 
A FIXED-LENGTH, DOUBLEWORD 
ALIGNED FIELD. 



SEGMENT #2 OF THIS RECORD IS 
A VARIABLE LENGTH HALFWORD 
ALIGNED FIELD WHOSE MAXIMUM 

LENGTH IS 70 BYTES. 



Figure 3 (Part 1 of 2) . Coding for file control table 
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DFHFCT TYPE=SEGDEF, SEGMENT #3 OF THE RECORD IS * 

SEGNAME=SEGMENT3, A FIXED-LENGTH UNALIGNED * 

SEGLENG=45 FIELD 

DFHFCT TYPE=SEGLAST END OF SEGMENT DEFINITIONS 
DFHFCT TYPE=SEGSET, * 

SEGSET=PATTERN1, * 

SEGNAME= (SEGMENT 1,SEGMENT2,SEGMENT3) 

DFHFCT TYPE=SEGLAST LAST SEGMENT ENTRY FOR MASTER 

DFHFCT TYPE=FINAL END OF FILE CONTROL TABLE 

DFHFCT TYPE=LOGICMOD CREATE DOS ISAM LOGIC MODULE 

END DFHFCTBA POINT TO REQUIRED ENTRY LABEL 

Figure 3 (Part 2 of 2) . Coding for file control table 

DESTINATION CONTROL TABLE (DCT) 

The Destination Control Table (DCT) is used to describe to CICS the 
destination name and certain other characteristics of data that is 
transient to CICS (that is, to be processed by the Transient Data 
Control program) . Entries are made to the DCT by coding the Destination 
Control Table macro instruction (DFHDCT) . 

Sequential extrapartition destinations are used for storing data 
external to the CICS partition/region or for retrieving data from 
outside the partition/region. Data stored for this purpose includes 
data received from terminals or other data created internally as the 
result of some transaction requirement identified by a user-written 
program. Extrapartition data may be both input and output data and is 
processed using QSAM under CICS/OS or SAM under CICS/DOS. 

Destination Control Table macro instructions are also used to specify 
intrapartition destinations. A single data set is used as intermediate 
storage for data to be directed to multiple intrapartition data 
destinations. Intrapartition data may be ultimately either transmitted 
upon request to the destination terminal or retrieved sequentially from 
the temporary data set for other uses. The user can specify, through 
the Destination Control Table, that a task is to be created when a 
certain number of records (trigger level) has been accumulated for an 
intrapartition destination. 

Included in the Destination Control Table is the appropriate 
user-prepared data set control information for all resident 
extrapartition data sets. This data set control information must follow 
the DFHDCT TYPE=INITIAL macro instruction. The extrapartition data 
sets supported under CICS are: blocked, unblocked, fixed, or variable. 

CICS provides the capability, in conjunction with the Dynamic 
Open/Close facility, to have nonresident (transient) data set control 
blocks and associated input/output areas and logic modules. Main 
storage normally encumbered for these storage areas is therefore 
available to the dynamic main storage area until the use of the storage 
areas is required. Nonresident data set control blocks are defined 
through the combination of DFHDCT TYPE=INITIAL and DFHDCT TYPE=SDSCI 
macro instructions. 

Whether the specified destinations are extrapartition or 
intrapartition (or indirect destinations pointing to either 
extrapartition or intrapartition destinations) , the symbolic names of 
the destinations must be provided by the user. Refer to Appendix A 
for a listing of the required destination identification (DESTID) 
entries. 
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The following operands can be included in the Destination Control 
Table (DFHDCT) macro instruction: 

DFHDCT TYPE=INITIAL, * 

SUFFIX=xx, * 

TRNSUFX=(xx,. . .) , * 
SEPASMB=YES,NO 

DFHDCT TYPE=SDSCI, * 

DSCNAME=name, * 

MODNAME=name, * 

DEVICE= 1403, 1404,1443, 1445,2311, 231 4,3330, TAPE, * 

BLKSIZE=length, * 

DEVADDR=symbolic address, * 

RECFOEM=FIXUNB,FIXBLK,VARUNB,VARBLK, * 

FILABL=STD,NO, * 

TYPEFLE=INPUT, OUTPUT, RDBACK, * 

RECSIZE=length, * 

REWIND=UNLOAD,NORWD, LEAVE, REREAD, * 

TPMARK=NO, * 

BUFNO=number, * 

ERROPT=SKIP, IGNORE, * 
SUFFIX=xx 

DFHDCT TYPE=EXTRA, * 

DSCNAME=name, * 

DESTID=name, * 

OPEN=INITIAL, DEFERRED, * 
RESIDNT=YES,NO 

DFHDCT TYPE=INTRA, * 

DESTID=name, * 

REUSE=YES,NO, * 

TRIGLEV=number, * 

DESTFAC=TERMINAL,FILE, * 
TRANSID=name 

DFHDCT TYPE=INDIRECT, * 

DESTID=narae, * 
INDDEST=narae 

DFHDCT TYPE=FINAL 



ESTABLISH CONTROL SECTION FOR DESTINATION CONTROL TABLE 

The entry point and beginning address for the Destination Control 
Table being defined are established by the 

DFHDCT TYPE=INITIAL, * 

SUFFIX=xx, * 

TRNSUFX= (XX,. . .) , * 
SEPASMB=YES,NO 

macro instruction. 

SUFFIX: Specifies a two-character alphameric suffix (other than 'NO 1 
which is reserved) for the Destination Control Table being assembled. 
This suffix, if specified, is appended to the standard module name 
(DFHDCT) and is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 
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TRNSUFX: Specifies a list of one- or two-character alphameric suffixes 
associated with nonresident data set control blocks. Any suffix 
appearing subsequently in the SUFFIX operand of the DFHDCT TYPE=SDSCI 
macro instruction must also appear in this list. These suffixes are 
used to punch the control cards for the CICS/DOS Linkage Editor 
(DFHLINK) or for the OS Linkage Editor (LINKEDIT) . Up to 255 suffixes 
can be specified. 

Note: During link-edit of DFHDCT there is one unresolved ADCON in each 
phase created under direction of TRNSUFX in DFHDCT TYPE=INITIAL. 
This message does not imply an error. 

SEPASMB: The SEPASMB=YES operand is used to indicate that only data 
set control information is to be generated; that is, the DFHDCT 
TYPE=INITIAL, DFHDCT TYPE=SDSCI, and DFHDCT TYPE=FINAL macro 
instructions are the only DFHDCT macro instructions to be included. 
The default is SEPASMB=NO. 



SPECIFY DATA SET CONTROL INFORMATION 

The data set control blocks (DTF's in CICS/DOS; DCB's in CICS/OS) 
are generated in response to the 

DFHDCT TYPE=SDSCI 

macro instruction. This macro instruction is needed only for 
extrapartition transient data and must have a DFHDCT TYPE=EXTRA macro 
instruction associated with it for resident data set control blocks. 
Note that all DFHDCT TYPE=SDSCI macro instructions must be issued 
immediately following the DFHDCT TYPE=INITIAL macro instruction and 
preceding any DFHDCT TYPE=EXTRA, DFHDCT TYPE=INTRA, or DFHDCT 
TYPE=INDIRECT macro instructions. 

The DFHDCT TYPE=SDSCI macro instruction can include the following 
operands: 

DFHDCT TYPE=SDSCI, * 

DSCNAME=name, * 

MODNAME=name, * 

DEVICE=1403, 1404, 1443, 1445, 231 1,23 14, 333 0, TAPE, * 

BLKSIZE=length, * 

DEVADDR=symbolic address, * 

RECFORM=FIXUNB,FIXBLK,VARUNB,VARBLK, * 

FILABL=STD,NO, * 

TYPEFLE=INPUT, OUTPUT, RDBACK, * 

RECSIZE=length, * 

REWIND=UNLOAD,NORWD, LEAVE, REREAD, * 

TPHARK=NO, * 

BUFNO=number, * 

ERROPT=SKIP, IGNORE, * 
SUFFIX=xx 

DSCNAME: Specifies the data set control name. This name must be the 
same as that specified in the DSCNAME operand of the DFHDCT TYPE=EXTRA 
macro instruction and is limited to seven characters in CICS/DOS or 
eight characters in CICS/OS. For CICS/OS, the DSCNAME is also the 
DDNAME and DCBNAME. 

MODNAME: Applicable only to the CICS/DOS systems, this operand is used 
to specify the name of the logic module to be used to process the 
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transient data set. If this operand is omitted, a standard DOS name 
is generated for calling the logic module. 

This operand can be used in conjunction with the DOS Subset/Superset 
Logic Module facility to reduce the number of logic modules reguired 
to process seguential data sets (where supersetting is permissible) . 

DEVICE: Applicable only to CICS/DOS, this operand specifies the type 
of input/output device. Valid device types are: 1403, 1404, 1443, 
1445, 2311, 2314, 3330, and TAPE. This operand is ignored in CICS/OS; 
instead, the device specified through the data definition (DD) statement 
is used. 

BLKSIZE: Specifies the length (in bytes) of the block (maximum length 
for variable length records) . For DOS disk output data sets, add eight 
bytes reguired by Logical IOCS for creation of the count field. 

DEVADDR: Applicable only to CICS/DOS, this operand specifies the 
symbolic unit address. This operand is not reguired for disk data sets 
when the symbolic address is provided via the CICS/DOS EXTENT card. 

RECFORM: Specifies the record format of the data set. Valid entries 
are: FIXUNB, FIXBLK, VARUNB, and VARBLK. For CICS/DOS, the default 
is RECFORM=FIXUNB. For CICS/OS, no default is provided; the record 
format specified in the data definition (DD) statement is used. 

FILABL: Applicable only to CICS/DOS, this operand specifies the type 
of label on tape data sets. Valid entries are STD or NO. The default 
is FILABL=NO. 

TYPEFLE: Indicates whether the data set is an input or output data 
set. The default is TYPEFLE=INPUT. . For CICS/OS, TYPEFLE=RDBACK 
specifies an input data set to be read backwards. 

Note: An extrapartition data set may be either INPUT or OUTPUT but 

not both. A system ABEND or unpredictable results may occur if 
output operations are specified for an INPUT data set or if 
input operations are specified for an OUTPUT data set. 

RECSIZE: Specifies the length (in bytes) of the record (maximum length 
for variable length records) . 

REWIND: Indicates the disposition of a tape data set. Valid entries 
are UNLOAD and NORWD for CICS/DOS, and LEAVE and REREAD for CICS/OS. 

TPMARK: Applicable only to CICS/DOS, the TPMARK=NO operand indicates 
that the writing of a tapemark at end of data set (file) is to be 
suppressed. 

BUFNO: Specifies the number of buffers to be provided. For CICS/DOS, 
any value other than 2 defaults to 1. For CICS/OS, any number up to 
255 may be specified; the default value is 1 . 
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ERROPT: Specifies the error option to be performed in the event of 
error. Valid parameters are SKIP and IGNORE. ERROPT=SKIP causes the 
block that caused the error to be skipped. ERROPT=IGNORE causes the 
block to be accepted. The default is ERROPT=IGNORE. 

SUFFIX: Specifies a one- or two-character alphameric suffix for the 
nonresident data set control block being generated. The use of this 
operand indicates that the data set control block being generated is 
nonresident. Nonresident data set control blocks reside on the 
Real-Time Relocatable Library (DFHRPL) under the unigue name DFHTRNxx, 
where "xx" is the suffix specified in this operand. The user-provided 
suffix characters must also be specified in the DFHDCT TYPE=INITIAL, 
TRNSUFX=(xx / ) list. 

For each data set control block generated via the DFHDCT TYPE=SDSCI, 
SUFFIX=xx macro instruction, the same suffixed name must be specified 
in the preparation of the Program Processing Table (DFHPPT TYPE=ENTRY, 
PROGRAM=DFHTRNxx) . 

For further information on the above operands, refer to the 
publication DOS Su pervi sor and Input/O ut put Mac ros (GC24-5037) or the 
publication OS Su pervis or and Data Man agement M acro Instructions 
(GC28-6647) . 

SPECIFY EXTRAPARTITION DESTINATIONS 

Destinations external to the system are specified using the 

DFHDCT TYPE=EXTRA 

macro instruction. This macro instruction must be coded once for every 
extrapartition destination. 

Extrapartition destinations that use nonresident data set control 
blocks are not reguired to be associated with a specific data set 
definition. When such destinations are opened, a one- or two-character 
suffix must be supplied to the Dynamic Open/Close program that indicates 
which nonresident data set control blocks are to be used for the 
destinations. 

The DFHDCT TYPE=EXTRA macro instruction includes the following 
operands: 

DFHDCT TYPE=EXTRA, * 

DSCNAME=name, * 

DESTID=name, * 

OPEN=INITIAL, DEFERRED, * 
RESIDNT=YES,NO 

DS.CNAME: Specifies the data set name the user must include in the 
DFHDCT TYPE=SDSCI macro instruction for destinations that use resident 
data set control blocks. This operand is not applicable for 
destinations that use nonresident data set control blocks. Nonresident 
data set control blocks are identified when the destination is opened. 

DESTID: Specifies the symbolic name of the extrapartition destination. 
The symbolic name is the same as that used in the transient data macro 
instruction (DFHTD) to specify the destination. Any destination 
identification of more than four characters is truncated on the right. 
Refer to Appendix A for a listing of the reguired destination 
identification entries. 
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OPEN: Applicable only to extrapartition destinations that use resident 
data set control blocks, this operand is used to specify how the data 
set associated with this destination is to be opened. OPEN=INITIAL 
indicates that the data set is to be opened during system 
initialization. OPEN=DEFERRED indicates that the user will open the 
data set during real-time execution of CICS. The default is 
OPEN=INITIAL for destinations that use resident data set control blocks. 

RESIDNT: Indicates whether this destination is to use resident or 
nonresident data set control blocks. The default is RESIDNT=YES. Those 
CICS/DOS extrapartition seguential disk data sets that are to be closed 
and re-opened by the dynamic Open/Close function of the Master Terminal 
Program must be defined as nonresident or records may be lost. , 

SPECIFY INTRAPARTITION DESTINATIONS 

Destinations for messages that are to be logged temporarily by CICS 
are specified using the 

DFHDCT TYPE=INTRA 

macro instruction. This macro instruction must be coded once for every 
intrapartition destination. 

The DFHDCT TYPE=INTRA macro instruction can include the following 
operands: 

DFHDCT TYPE=INTRA, * 

DESTID=name, * 

REUSE=YES,NO, * 

TRIGLEV=number r * 

DESTFAC=TERMINAL,FILE, * 
TRANSID=name 

DESTID: Specifies the symbolic name of the intrapartition destination. 
The symbolic name is the same as that used in the Transient Data macro 
instruction (DFHTD) to specify the destination. Any destination 
identification of more than four characters is truncated on the right. 
Refer to Appendix A for a listing of the reguired destination 
identification entries. 

If the ultimate destination of the data is a terminal and if 
automatic task initiation is associated with the destination, the name 
specified in the DESTID operand must be the same as the name specified 
in the TRHIDNT operand of the DFHTCT TYPE=TERMINAL macro instruction. 
The user may find it convenient to use the same naming convention for 
terminal destinations and data set destinations, regardless of whether 
automatic task initiation is requested. 

REUSE: REUSE=YES specifies that intrapartition storage tracks for this 
destination are to be released as they are read and returned to the 
pool of available tracks. REUSE=NO specifies that intrapartition 
storage tracks for this destination are not to be released until a 
Transient Data PURGE macro instruction is issued; the PURGE macro 
instruction causes all tracks associated with this DESTID to be 
released. The default is REUSE=YES. 

TRIGLEV: Specifies the number of data records (trigger level) to be 
accumulated for a destination before automatically requesting the 
creation of a task to process these records. The ultimate destination 
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is normally a data set or terminal. If the TRANSID operand has been 
used, and if no trigger level has been specified, TRIGLEV defaults to 
a value of 1. The maximum which may be specified is 32767. (If the 
ultimate destination is a 2741 Communication terminal, the task to be 
initiated is not initiated until that terminal receives data.) 

If TRIGLEV=0, automatic task initiation does not occur; the data 
records accumulate until some program, however initiated, is executed 
and issues a DFHTD TYPE=GET macro instruction to access the records. 
If the execution of a DFHTD TYPE=PUT macro instruction results in the 
trigger level being reached (or exceeded) for a non-terminal 
destination, and if either a "maximum tasks" or "short on storage" 
condition exists for CICS, the task to be automatically initiated is 
not initiated until a subsequent PUT to the same destination occurs 
with the stress condition no longer existing. 

DESTFAC: If TRANSID has been specified, DESTFAC specifies the type of 
destination (TERMINAL or FILE) that the queue represents. If no 
destination is specified, the default is DESTFAC=TERMINAL. 

If DESTFAC=TERMINAL, task initiation to process the queue is by 
Terminal Control. If DESTFAC=FILE, task initiation is by Transient 
Data Control. 

TRANSID: Provides identification for the transaction that is to be 
automatically initiated when the trigger level is reached. If this 
operand is omitted, the application program must initiate the read 
operation. 

SPECIFY INDIRECT DATA DESTINATIONS 

Indirect data destinations can be specified within the Destination 
Control Table using the 

DFHDCT TYPE=INDIRECT 

macro instruction. The indirect data destination does not point to an 
actual data set but instead points to another destination. 

For example, assume the user develops functional symbolic names for 
the destinations of several message types. These, in turn, may point 
to one actual destination. At a later time the user might choose to 
direct one of the message types to another destination. The user does 
not change his programs but only alters the indirect destination name. 

The DFHDCT TYPE=INDIRECT macro instruction can include the following 
operands: 

DFHDCT TYPE=INDIRECT, * 

DESTID=name, * 

INDDEST=name 

DESTID: Specifies the four-character symbolic name of a particular 
indirect destination. The symbolic name is the same as that used in 
the Transient Data macro instruction (DFHTD) . Refer to Appendix A for 
a listing of the required destination identification entries. 

INDDEST: Specifies the symbolic identification of an intrapartition 
or extrapartition destination. This identification must be the same 
as the DESTID of the actual destination. 
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TERMINATE ENTRIES FOR THE DESTINATION CONTROL TABLE 

Entries for the Destination Control Table are terminated by the 

DFHDCT TYPE=FINAL 

macro instruction. This macro instruction must be the last statement 
in the assembly of every Destination Control Table before the Assembler 
END statement. The Assembler END statement must include the label 
DFHDCTBA. 

NONRESIDENT EXTR APARTITION DATA SET DEFINITION 

The definition of nonresident extrapartition data sets is 
accomplished through use of the DFHDCT TYPE=INITIAL and DFHDCT 
TYPE=SDSCI macro instructions. The data set control blocks and 
associated input/output areas are generated and cataloged to the 
Real-Time Relocatable Program Library (DFHRPL) as a separate table for 
each nonresident data set control block to be used. There must be an 
entry in the Processing Program Table (PPT) for each nonresident data 
set control block. The format of the name is DFHTRNxx, where "xx" 
represents the suffix character (s) specified in the DFHDCT TYPE=SDSCI, 
SUFFIX=xx macro instruction. The PPT entry for these data set control 
blocks must include the RELOAD=YES operand. 

In CICS/OS, the necessary access methods are acguired when data sets 
are opened. Therefore references to transient access methods (logic 
modules) in the following discussion are applicable primarily to 
CICS/DOS. 

In the CICS/DOS systems, the logic modules for the nonresident data 
set control blocks may also be transient. If the use of nonresident 
logic modules is desired, the logic modules must be assembled and 
cataloged to DFHRPL prior to execution. The logic modules are assembled 
using the standard DOS SAM macro instructions and must be cataloged 
with the same program name generated by the nonresident data set control 
block for which it is to be used. The name can be found in the assembly 
of the data set control block. Unless otherwise specified in the DFHDCT 
TYPE=SDSCI macro instruction, this name is the standard DOS logic module 
name. 

The PPT entry for each nonresident logic module must include the 
RELOAD=YES operand. 

In CICS/DOS, if the DCT is generated to include the nonresident data 
set control block definitions, the logic modules for both the resident 
and nonresident data set control blocks are link edited into the DCT. 
To allow the logic modules to be transient, the DCT should be assembled 
including only the resident data set control block definitions (DFHDCT 
TYPE=SDSCI) . A separate assembly can then be accomplished to generate 
only the nonresident data set control blocks. To perform this 
operation, include a DFHDCT TYPE=INITIAL, TRNSUFX= (xx, . . . ) , SEPASMB=YES 
macro instruction, followed by DFHDCT TYPE=SDSCI macro instructions 
for all nonresident data set definitions, followed by the DFHDCT 
TYPE=FINAL macro instruction. 

DESTINATION CONTROL TABLE EXAMPLES 

Figure 4 contains an example of the coding reguired to generate a 
Destination Control Table that uses resident data set control blocks. 
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DFHDCT TYPE=I 

DFHDCT TYPE=S 
DSCNAM 
DEVADD 
DEVICE 
RECFOR 

DFHDCT TYPE=E 
DSCNAM 
DESTID 

DFHDCT TYPE=I 
DESTID 

DFHDCT TYPE=I 
DESTID 

DFHDCT TYPE=I 
DESTID 
TRIGLE 
DESTFA 
TRANSI 

DFHDCT TYPE=F 

END DFHDCTBA 



NITIAL 

DSCI, 

E=DFHXTRA, 

R=SYSLST, 

=1403, 

M=FIXUNB 

XTRA, 

E=DFHXTRA, 

=CASH 

NTRA, 

=GAMA 

NTRA, 

= SAMA 

NTRA, 

=DAMA, 

V=5, 

C=TERMINAL, 

D=AUTO 

INAL 



START OF DEST CONTROL TABLE 
SPECIFY DATA SET CONTROL INFO 
RELATED DESTINATION 
SYMBOLIC UNIT ADDRESS 
DEVICE TYPE 
RECORD FORMAT 
EXTRAPARTITION DESTINATION 

SYMBOLIC NAME 

INTRAPARTITION DESTINATION 
SYMBOLIC NAME 

SYMBOLIC NAME 

SYMBOLIC NAME 



TRANSACTION ID 

END OF DEST CONTROL TABLE 

POINT TO REQUIRED ENTRY LABEL 



Figure 4. DCT using resident data set control blocks 
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Figures 5 and 6 show how the generation of a DCT can include 
extrapartition destinations that use nonresident data set control 
blocks. Figure 5 shows a DCT with nonresident data set control blocks 
and resident logic modules. Figure 6 shows a DCT with nonresident data 
set control blocks and nonresident logic modules. 



DFHDCT TYPE=INITIAL, 

TRNSUFX=(AA,BB,CC,DD) , 

SUFFIX=22 
DFHDCT TYPE=SDSCI / 

DSCNAME=TAPE1, 

RECFORM=FIXBLK, 

TYPEFLE=OUTPUT, 

BLKSIZE=2000, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

BUFN0=2, 

RECSIZE=200 r 

SUFFIX=AA 
DFHDCT TYPE=SDSCI r 

DSCNAME=TAPE2, 

RECFORM=FIXBLK, 

TYPEFLE=INPUT, 

BLKSIZE=2000, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

BUFN0=2, 

RECSIZE=200, 

SUFFIX=BB 
DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE3, 

RECFORM=FIXUNB, 

BLKSIZE=1240, 

TYPEFLE=INPUT, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

SUFFIX=CC 
DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE4, 

RECFORM=FIXUNB, 

BLKSIZE=1240, 

TYPEFLE=OUTPUT, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

SUFFIX=DD 
DFHDCT TYPE=SDSCI, 

DSCNAME=PRINT r 

RECFORM=VARUNB, 

BLKSIZE=121, 

DEVADDR=SYSLST, 

DEVICE=1403 
DFHDCT TYPE=EXTRA, 

DSCNAME=PRINT, 

DESTID=PRNT 
DFHDCT TYPE=EXTRA, 

RESIDNT=NO, 

DESTID=TAPE 
DFHDCT TYPE=FINAX 
END DFHDCTBA 



Figure 5. DCT using nonresident data set control blocks and resident 
logic modules 
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The assembly of the macro instructions contained in Figure 5 results 
in a Destination Control Table with suffix 22 (DFHDCT22) that contains 
one data set control block for the printer (TYPE=SDSCI r DESTID=PRNT) . 
When the output of this generation is link edited, the logic modules 
for tape and printer are automatically included, and the four tape data 
set control blocks are cataloged separately to DFHRPL as DFHTRNAA, 
DFHTRNBB, DFHTRNCC, and DFHTRNDD. 

The extrapartition destination (DESTID=TA?E) can be opened through 
the CICS Dynamic Open/Close program with any of the four suffixed data 
set control blocks (DFHTRNAA, DFHTRNBB, DFHTRNCC, or DFHTRNDD) . It 
can then be closed and reopened with any of the other nonresident data 
set control blocks. 

Program Processing Table (PPT) entries must be included for the four 
data set control blocks cataloged separately. PPT entries must include 
the RELOAD=YES operand. 



DFHDCT TYPE=INITIAL, 

TRNSUFX= (AA,BB,CC,DD) 
SEPASMB=YES 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE1, 

RECFORM=FIXBLK, 

TYPEFLE=OUTPUT, 

BLKSIZE=2000, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

BUFN0=2, 

RECSIZE=200, 

SUFFIX=AA 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE2, 

RECFORM=FIXBLK, 

TYPEFLE=INPUT, 

BLKSIZE=2000, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

BUFNO=2, 

RECSIZE=200, 

SUFFIX=BB 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE3, 

RECFORM=FIXUNB, 

BLKSIZE=1240, 

TYPEFLE=INPUT, 

DEVADDR=SYS011 , 

DEVICE=TAPE, 

SUFFIX=CC 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE4, 

RECFORM=FIXUNB, 

BLKSIZE=1240, 

TYPEFLE=OUTPUT, 

DEVADDR=SYS011, 

DEVICE=TAPE, 

SOFFIX=DD 

DFHDCT TYPE=FINAL 

END DFHDCTBA 



Figure 6 (Part 1 of 2) . 



DCT using nonresident data set control 
blocks and nonresident logic modules 
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DFHDCT TYPE=INITIAL, * 

SUFFIX=YY 
DFHDCT TYPE=SDSCI / * 

DSCNAME=PRINT, * 

RECFORM=VARUNB r * 

BLKSIZE=121, * 

DEVADDR=SYSLST, * 

DEVICE=1403 
DFHDCT TYPE=EXTRA, * 

DSCNAME=PRINT, * 

DESTID=PRNT 
DFHDCT TYPE=EXTRA, * 

RESIDNT=NO, * 

DESTID=TAPE 
DFHDCT TYPE=FINAL 
END DFHDCTBA 

Figure 6 (Part 2 of 2) . DCT using nonresident data set control blocks 

and nonresident logic modules 

The result of the generation of the macro instructions contained in 
Figure 6 (Part 2 of 2) is a Destination Control Table with a suffix of 
YY (DFHDCTYY) . The DCT contains one data set control block for the 
printer (TYPE=SDSCI, DESTID=PRNT) and one logic module for the printer. 

The four data set control blocks for tape are generated by the 
assembly of the macro instructions contained in Figure 6 (Part 1 of 
2) . When the output of that assembly is link edited, the data set 
control blocks are cataloged as DFHTRNAA, DFHTRNBB, DFHTRNCC, and 
DFHTRNDD. However, the user must have cataloged the logic modules used 
by these four data set control blocks to DFHRPL using DFHLINK, and must 
have included entries in the PPT that specify the RELOAD=YES operand 
for those logic modules. 

When using the generated DCT of Figure 6, no storage is used for 
the data set control blocks or for the logic modules until the 
extrapartition destination (DESTID=TAPE) is opened via the CICS Dynamic 
Open/Close program (DFHOCP) . The Dynamic Open/Close program will ensure 
that only one logic module of the same name is in storage at any one 
time. If the logic module is not resident in the DCT, the Dynamic 
Open/Close program frees the storage associated with the logic module 
when the data set is closed. 

For further details concerning the use of the Dynamic Open/Close 
facility, see the discussion of dynamic open/close in the "Master 
Terminal" section and the "Dynamic Open/Close Function" section of this 
manual. 



PROGRAM CONTROL TABLE (PCT) 

The Program Control Table is the means for the user to describe the 
control information to be used by CICS for identifying and initializing 
a newly-arrived transaction. Task Control uses a portion of each PCT 
entry for the purpose of accumulating transaction statistics. This 
table is required by the control system to verify the incoming 
transaction, supply the transaction priority and security key, supply 
the length of the Transaction Work Area, and keep transaction 
statistics. 
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The following operands can be included in the DFHPCT macro 
instruction: 

DFHPCT TYPE=INITIAL, * 

SUFFIX=xx 

DFHPCT TYPE=ENTRY, * 

TRANSID=name, * 

TRNPRTY=decimal value, * 

TRANSEC=decimal value, * 

TtfASIZE=decimal value, * 

PROGRAM=name, * 

TPURGE=YES,N0, * 

SPURGE=YES,NO, * 
COMPAT=NO,FORMAT,FULLBUF 

DFHPCT TYPE=FINAL 



ESTABLISH CONTROL SECTION FOR PROGRAM CONTROL TABLE 

The control section into which the Program Control Table is assembled 
is established by the 

DFHPCT TYPE=INITIAL, * 

SUFFIX=xx 

macro instruction. This macro instruction must be coded as the first 
statement in the source deck used to assemble the Program Control Table. 

SUFFIX: Specifies a two-character alphameric suffix for the Program 
Control Table being assembled. This suffix, if specified, is appended 
to the standard module name (DFHPCT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, a suffix 
is not provided. 

SPECIFY TRANSACTION CONTROL INFORMATION 

Transaction control information is provided to CICS program 
management services by the 

DFHPCT TYPE=ENTRY 

macro instruction. Included in this macro instruction is information 
on priority, security key, program identification, purge indicators, 
and size of the Transaction Work Area. 

The DFHPCT TYPE=ENTRY macro instruction includes the following 
operands: 

DFHPCT TYPE=ENTRY, * 

TRANSID=name, * 

TRNPRTY=decimal value, * 

TRANSEC=decimal value, * 

TWASIZE=decimal value, * 

PROGRAM=name, * 

TPURGE=YES,NO, * 

SPURGE=YES,NO, * 
COMPAT=NO,F0RMAT,FULLBUF 

TRANSID: Used to specify the four-character identification assigned 
to the individual transaction. Note that TRANSID=DISC should not be 
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specified if terminals are to be supported on switched , lines. For 
further details concerning the use of terminals on switched lines, see 
the CICS Terminal Operator' s Guide. 

TRNPRTY: Used to define the transaction priority. This three-position 
decimal value (000-255) is used in establishing the overall transaction 
processing priority. (Transaction processing priority is egual to the 
sum of the terminal priority, transaction priority, and operator 
priority, not to exceed 255.) If this operand is omitted, the default 
is TBNPRTY=001. 

TRANSEC: Used to define the transaction security, the TRANSEC parameter 
is a three-position decimal value with a range 001 through 024. The 
default is TRANSEC=001. 

TWASIZE: Used to define the Transaction Work Area reguired. A 
five-position decimal value that determines the size (in bytes) of the 
Transaction Work Area to be acquired for this transaction. Refer to 
Appendix A for the minimum values that must be specified for programs 
provided by CICS. The default is TWASIZE=0. 

PROGRAM: Used to define the initial program identification; this 
operand specifies the name of the program to which control is to be 
given to process this transaction. 

TPURGE: Used to set the terminal error purge indicator. TPURGE=YES 
indicates that the terminal error purge indicator is to be set to allow 
the transaction to be purged when a terminal error occurs. The default 
is TPURGE=NO. 

SPURGE: Used to set the system stall purge indicator. SPURGE=NO 
indicates that the transaction is not purgeable when a system stall 
condition is detected. The default is SPURGE=NO. 

COMPAT: Used to flag those transactions that are to be run in 2260 
compatibility mode on the 3270 Information Display System. The default 
is COMPAT=NO. 

COMPAT=FORMAT indicates that the transaction is to be run in FORMAT 
mode; COMPAT=FULLBUF indicates that the transaction is to be run in 
FULLBUF mode. For a discussion of FORMAT and FULLBUF modes of 
compatibility operation, see the section "2260 Compatibility for the 
3270". 



SPECIFY END OF PROGRAM CONTROL TABLE 

The end of the Program Control Table is indicated by the 

DFHPCT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Program Control Table before the Assembler END statement. This macro 
instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHPCTBA. 
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PROGRAM CONTROL TABLE EXAMPLE 

Figure 7 illustrates the coding that is reguired to create a Program 
Control Table. The transactions include: 

1. Three transactions of a higher priority than the default priority 

(TRNPRTY=1 is the default) 

2. Two transactions with security key protection 

3. Total of nine transactions 

See Appendix A for a list of all the entries required to create a 
Program Control Table. 

DFHPCT TYPE=INITIAL 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B1 , * 

TWASIZE=6U, * 
PR0GRAM=C0BPGM1 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B2, * 

TRNPRTY=100, * 

TRANSEC=10, * 
PR0GRAM=C0BPGM2 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B3, * 

TWASIZE=100, * 

TRANSEC=5, * 

PR0GRAM=C0BPGM3, * 
TPDRGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B4, * 

PR0GRAM=C0BPGM4 r * 
TPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSAC, * 

TRNPRTY=5, * 

TWASIZE=40, * 
PROGRAM=DFHACP 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSMT, * 

TWASIZE=160, * 
PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSST, * 

TWASIZE=100 # * 
PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSTA, * 

TWASIZE=000, * 
PROGRAM=DFHTAJP 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSSN, * 

TRNPRTY=99, * 

TWASIZE=000, * 

PROGRAM=DFHSNP, * 
SPURGE=YES 

DFHPCT TYPE=FINAL 

END DFHPCTBA 

Figure 7. Coding for program control table 
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PROCESSING PROGRAM TABLE (PPT) 

The Processing Program Table provides a means for the user to 
describe to Program Control the control information concerning the 
processing programs. In addition. Program Control uses portions of 
each table entry to retain certain information for maintaining control 
of the user's programs and to capture specified program statistics. 

This table is required by CICS to verify the processing program 
identification, to keep count of the number of transactions using that 
program, to maintain the address of the processing program, to 
communicate to CICS the type of load used for the program, to maintain 
the direct access address and size of the program, and to maintain 
statistics on the processing program. 

The Processing Program Table macro instruction (DFHPPT) specifies 
processing programs to be recognized by CICS. The following operands 
can be included in the DFHPPT macro instruction: 

DFHPPT TYPE=INITIAL, * 

SUFFIX=xx 

DFHPPT TYPE=ENTRY, * 

PROGRAM=name, * 

PGMLANG=ASSEMBLER, COBOL, PL/I, * 

RES=YES,NO, * 
RELOAD=YES,NO 

DFHPPT TYPE=FINAL 

Those programs most often used during execution of CICS should be 
specified first during preparation of the Processing Program Table. 

ESTABLISH CONTROL SECTION FOR PROCESSING PROGRAM TABLE 

The control section into which the Processing Program Table is 
assembled is established by the 

DFHPPT TYPE=INITIAL, * 

SOFFIX=xx 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Processing Program Table. 

SUFFIX: Specifies a two-character alphameric suffix for the Processing 
Program Table being assembled. This suffix, if specified, is appended 
to the standard module name (DFHPPT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, a suffix 
is not provided. 

DESCRIBE PROCESSING PROGRAMS 

A specific processing program is described to CICS program management 
services by the 

DFHPPT TYPE=ENTRY 

macro instruction. Included is information on the program name and 
the type of program. 

The DFHPPT TYPE=ENTRY macro instruction includes the following 
operands: 
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DFHPPT TYPE=ENTRY, * 

PRCGRAM=name, * 

PGMLANG=ASSEMBLER, COBOL, PL/I, * 

RES=YES,NO, * 
RELOAD=YES,NO 

PROGRAM: Specifies the program identification, up to eight characters 
in length. The indicated program must have been previously link edited 
into the Real-Time Relocatable Program Library (DFHRPL) . 

PGMLANG: Specifies the type of program. The default is 
PGMLANG=ASSEMBLER. Omit this parameter when preparing PPT entries for 
BMS maps regardless cf the compiler used. 

RES: Used to indicate whether or not the program is to be made resident 
in main storage when CICS is initialized. In the CICS/DOS-ENTEY system, 
the designated programs become permanently resident, and the size of 
dynamic storage (subpool 0) is reduced. For the CICS/DOS-STANDARD and 
CICS/OS-STANDARD systems, the designated programs are "packed" into 
the high portion cf the user's dynamic main storage. The default is 
RES=NO. 

RELOAD: RELOAD=YES indicates that a fresh copy of the program is to 
be loaded by the Program Control program each time a load reguest for 
that program is issued. It is the user's responsibility to release 
the storage, it is not automatically released when the transaction 
terminates. A Storage Control FREEMAIN, rather than a Program Control 
DELETE, must be used to free the storage. The default is RELOAD=NO. 

If the Dynamic Open/Close program is to be used, RELOAD=YES must be 
specified in each PPT entry that defines a nonresident data set control 
block. 

RELOAD=YES must also be specified for all CICS/DOS transient logic 
modules. The Dynamic Open/Close program maintains a use count for the 
logic modules to ensure that only one copy is in main storage at any 
one time. If the logic module is resident in the Destination Control 
Table, no entry is necessary in the PPT. In the DOS-ENTRY System, 
storage for the program is obtained from subpcol 0. 

SPECIFY END OF PEOCESSING PROGRAM TABLE 

The end of the Processing program Table is indicated to the control 
system by the 

DFHPPT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Processing Program Table before the Assembler END statement. This 
macro instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHPPTBA. 

PROCESSING PROGRAM TABLE EXAMPLE 

Figure 8 illustrates the coding that is reguired to create a 
Processing Program Table. The programs include: 

1. Four Assembler language programs, one of which is resident 

2. Four ANS COBOL programs 
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See Appendix A for a list of all the entries reguired to create a 
Processing Program Table. 

DFHPPT TYPE=INITIAL 

DFHPPT TYPE=ENTRY, * 

PRCGBAM=C0BPGM1, * 

PGMLANG=COEOL 
DFHPPT TYPE=ENTRY, * 

PR0GRAM=C0BPGM2, * 

PGMLANG=CCBOL 
DFHPPT TYFE=ENTRY, * 

PRCGRAM=C0BPGM3, * 

PGMLANG=COEOL, * 

RELOAD=YES 
DFHPPT TYFE=ENTRY, * 

PR0GBAM=C0BPGM4, * 

PGMLANG=COEOL 
DFHPPT TYPE=ENTRY, * 

PRCGEAM=DFHACP 
DFHPPT TYPE=ENTRY, * 

PROGEAH=DFHTAJP 
DFHPPT TYFE=ENTRY, * 

PROGRAM=DFHMTPA 
DFHPPT TYPE=ENTRY f * 

PROGEAM=DFHSNP 
DFHPPT TYPE=FINAL 
END DFHPPTBA 

Figure 8. Coding for processing program table 

SYSTEM SERVICE TABLES 

The system service tables (optional) provide the user with increased 
control over the operation of CICS. The system service tables are: 

1. Sign-on Table that contains the operator security and priority 
data to permit an operator to sign on the system. 

2. Terminal List Tables that contain, by groups, the identification 
of terminals that are related logically; for example, the 
terminals in a remote location or all terminals whose operators 
are under the control of a supervisor. A supervisor, through 
his table, may alter the status of a terminal under his control. 
For example, he could place a terminal in an out-of-service 
condition. 

The Sign-^on Table and the Terminal List Tables reside on a direct 
access storage device and are called into main storage as required. 
The use of a Sign-on Table or a Terminal List Table requires that 
FCPLOAD=YES be specified for DFHSG PEOGRAM=PCP macro instruction. Refer 
to the CICS Terminal Operator's Guide for the terminal operator 
procedures using the system service tables and programs. 

SIGN-ON TABLE (SNT) 

The Sign-on Table provides the means for permanently retaining 
terminal operator data. It is accessed when a terminal operator 
initiates the sign-cn procedure. 

During the sign-on procedure, the name of the terminal operator is 
entered at the terminal and is used to locate the appropriate operator 
entry in the table. The operator entry in the table contains data used 
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to verify the operator name and to establish a priority and a security 
key for the transactions which the operator subsequently enters. 

The priority value related to the operator is used to develop the 
task priority for processing a transaction. The operator's security 
key is used in a security check of all transactions subsequently 
entered. The security key which is placed in the appropriate Terminal 
Control Table entry for the operator is matched with the transaction 
security contained in the transaction's Program Control Table (PCT) 
entry. 

If the operator security key contains any position that matches the 
security value in the PCT entry, the transaction is accepted. 
Otherwise, a security check has occurred and the transaction is 
terminated. A security key of 1 is the default option in the creation 
of the Sign-on Table, the Program Control Table, and the Terminal 
Control Table; this value is present in the Terminal Control Table 
until altered by a sign-on procedure. The security key default option 
allows transactions with a transaction security of 1 to be entered into 
the system by the operator without the sign-on procedure. 

The Sign-on Table macro instruction (DFHSNT) specifies the terminal 
operator data for the users of CICS. A DFHSNT entry should be present 
in the Sign-on Table for each terminal operator who is expected to sign 
on. 

The Sign-on Table must be assembled, link edited with the name 
DFHSNT, and represented in the Processing Program Table (PPT) . 

The following operands can be included in the DFHSNT macro 
instruction: 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME='operator name', * 

PASSWRD=password, * 

OPIDENT=operator identification, * 

SCTYKEY=(n1,. . ,,n24) , * 
OPPRTY=operator priority 

DFHSNT TYPE=FINAL 

Establish Sign-o n Table Control Section 

The control section into which the Sign-on Table is assembled is 
established by the 

DFHSNT TYPE=INITIAL 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Sign-on Table. 
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Describe Te rmi nal O p e rato rs 

Each terminal operator is described to CICS through an entry in the 
Sign-on Table. These entries are made by issuing the 

DFHSNT TYPE=ENTRY 

macro instruction. Included in this macro instruction is information 
on password, operator identification, security key, and operator 
priority. 

The DFHSNT TYPE=ENTRY macro instruction includes the following 
operands: 

DFHSNT TYPE=ENTRY, * 

OPNAME= , operator name', * 

PASSWRD=password, * 

OPIDENT=operator identification, * 

SCTYKEY=(n1,.. . ,n24) , * 
OPPRTY=operator priority 

OPNAME: Specifies the name of the terminal operator for this table 
entry. The operator name may be 1 to 20 characters long and must be 
unique for each entry. The operator name in this entry must be matched 
exactly by the operator name entered in the sign-on procedure. 

PASSWRD: Specifies a four-character password (identification) created 
by the user. The password entered by a terminal operator as a part of 
the sign-on procedure must be matched exactly by the password in the 
operator's Sign-on Table entry. Passwords may be unique to each 
operator or the same for a logical group of operators. 

OPIDENT: Used to specify the three-character operator identification 
code assigned by the user to each operator. This code is placed in 
the appropriate Terminal Control Table terminal entry (TCTTE) when the 
operator signs on so that the identity of the operator is known to 
CICS. This operator identification is made available to the master 
terminal when a security violation is detected. 

SCTYKEY: Specifies one or more decimal security-key values from 1 to 
24. The security key for a terminal operator is comprised of those 
values which are to be matched with the transaction security of an 
appropriate program control table entry. The security key may be built 
with from 1 to 24 individual values. Each decimal value in the range 
of 1 to 24 specified in the operand of the SCTYKEY keyword has a 
corresponding bit position in a three-byte SCTYKEY field. The presence 
of each value in the operand causes the corresponding relative bit 
position to be set on. 

The transaction security in a Program Control Table entry is 
specified as only one of the possible 24 individual values. The same 
value must be contained in the operator's security key to allow the 
operator to process that transaction. The operator's security key is 
not limited to just one value and likely contains several values. 

The default is SCTYKEY=1. It will also be a value whether or not 
it is specified. 

OPPRTY: Specifies a decimal operator priority value from to 255. 
An operator priority is assigned optionally by the user and is used in 
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developing the task processing priority for each transaction. The 
default is OPPRTY=0. 

Sp_ecify. End of Si gn- on Table 

The end of the Sign-on Table is indicated by the 

DFHSNT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Sign-on Table before the Assembler END statement. This macro 
instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHSNTBA. 

Si£Hz2H Table Example 

Figure 9 contains an example of coding for the Sign-on Table. In 
this example, there are two cases of the operator name being actual 
names and one instance of the name being a function. The first operator 
has access to transactions whose transaction securities are 1,2,7, or 
24. The other two operators have access to the same transactions as 
the first plus additional transactions. The second operator has a 
default priority of zero. 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME='DON GIBSON', * 

PASSWRD=DIST, * 

OPIDENT=DG, * 

SCTYKEY= (1,2,7,24) , * 
0PPRTY=128 

DFHSNT TYPE=ENTRY # * 

OPNAME='R. J. JONES', * 

PASSWRD=DIST, * 

OPIDENT=RJJ, * 
SCTYKEY= (1,2,7,9,24) 

DFHSNT TYPE=ENTRY, * 

OPNAHE='HASTER TERMINAL 1', * 

PASSWRD=MAST, * 

0PIDENT=MT1, * 

SCTYKEY=(1,2,3,4,7,9,24) , * 
OPPRTY=255 

DFHSNT TYPE=FINAL 

END DFHSNTBA 

Figure 9. Coding for sign-on table 

TERMINAL LIST TABLES (TLT) 

The Terminal List Tables provide the user of CICS with the means of 
retaining the terminal identifications in logical groupings. A logical 
grouping of terminals could be all the terminals that are under the 
control of a supervisor. Each supervisor might have a Terminal List 
Table. All terminals which serve a similar function represent a logical 
grouping, or class of terminals. The user might create a grouping of 
terminal identifications to facilitate the dispatching of general 
messages to terminals. 

The system service programs of CICS use Terminal List Tables to 
perform terminal status change operations. A unigue Terminal List 
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Table must be created for each supervisor who is to have the ability 
to alter the terminal status of any terminal under his control. Any 
operation which is to change the status of an entire group of terminals 
reguires a Terminal List Table containing the identifications of all 
terminals in that group. Unigue identification is assigned to each 
table by the user. 

The creation of the Terminal List Tables is accomplished through 
the assembly procedure by using the DFHTLT macro instruction. The 
following operands can be included in this macro instruction: 

DFHTLT TY.PE=INITIAL, * 

SUFFIX=xx 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=terminal identification 

DFHTLT TYPE=FINAL 

The Terminal List Table must be assembled and link edited with a 
name that conforms to the format: DFHTLTxx. The base name is DFHTLT. 
The two-character suffix (xx) , uniguely identifying this table, consists 
of the same characters entered by a user of the system service programs 
for terminal status change. These two characters are appended to the 
base name (DFHTLT) for the retrieval process, and may represent either 
a supervisor's identification or the identification of a class of 
terminals. 

There must be an entry in the Processing Program Table (PPT) for 
each Terminal List Table the user wishes to access. 

Establish Termi nal List Table Control Section 

The control section into which the Terminal List Table is assembled 
is established by the 

DFHTLT TYPE=INITIAL, * 

SUFFIX=xx 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Terminal List Table. 

SUFFIX: This operand is used to specify a two-character suffix for 
the Terminal List Table being assembled. This suffix, if specified, 
is appended to the standard module name (DFHTLT) and is used to name 
the module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 

Specify T ermina l Identification 

The terminal identifications to be included in the Terminal List 
Table are specified through the 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=terminal identification list 

macro instruction. Any number of these macro instructions can appear 
in a Terminal List Table assembly. 

TRMIDNT: Specifies a list of terminal identifications to be included 
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in the table. Any symbolic identification used must first have been 
defined in the TRMIDNT operand of the DFHTCT macro instruction. 

Sfiecify. End of Terminal List Tab le 

The end of the Terminal List Table is indicated by the 

DFHTLT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Terminal List Table before the Assembler END statement. The Assembler 
END statement must include the label DFHTLTBA. 

Terminal List Table Example 

Figure 10 illustrates the coding required to create a Terminal List 
Table. 



DFHTLT TYPE=INITIAL, * 

SUFFIX=AA 
DFHTLT TYPE=ENTRY, * 

TRMIDNT= (NYC,CHI,LA,WDC) 
DFHTLT TYPE=ENTRY, * 

TRMIDNT= (SF,ATL) 
DFHTLT TYPE=FINAL 
END DFHTLTBA 



Figure 10. Coding for terminal list table 
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SYSTEM PROGRAMMING CONSIDERATIONS 



CREATING USE R EXITS FOR CICS MANAGEMENT PROG RAMS 

CICS provides a technique for incorporating user-written source code 
into most of the CICS management programs. This source code may extend 
various CICS management functions. So long as the user conforms to 
certain restrictions and conventions, this facility should minimize 
the impact of CICS source code modifications when installing new 
releases of CICS. 

To include a user-written exit routine in a particular CICS 
management program, the user must place his source code in a CICS source 
library member (book) which has the naming convention: 

DFHxxEXT 

where xx is the two-character designation for the management program 
into which the user-written code is to be included. The two-character 
designations are: 

KC (Task Control) 

SC (Storage Control) 

PC (Program Control) 

TC (Terminal Control) 

FC (File Control) 

IC (Interval Control) 

TD (Transient Data Control) 

TS (Temporary Storage Control) 

The code provided by the user in a given member (book) may consist 
of more than one routine (function) depending upon the number of 
linkages provided in the particular CICS management program. For 
example. File Management provides linkage to user-written exit routines 
both before and after an input operation. Thus, user-supplied code in 
the member (book) DFHFCEXT might contain two routines, each identified 
by a unique symbolic name. 

Linkage from the CICS management program to the appropriate 
user-written exit routine is accomplished by one of the following 
methods: 

1. An Assembler BAL instruction that uses the user-defined symbolic 
name as the "branch to" label and general register 14 as a return 
register. 

2. Register 14 is loaded with an address constant for the user 
defined symbolic name and a BALR 14, 14 instruction is issued. 

Note: The user-written exit routines are located at the end of the 

management programs. The length of some programs is such that 
the exit routines are not addressable by the program's base 
register (s) . This situation forces the use of method two above, 
and requires the exit routine to establish its own addressability 
upon gaining control. 

Under method one at least some beginning part of the user exit 
routine is addressable by a management program base register. 
Another base register may be required for the rest of the exit 
routine. 
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The symbolic name of the exit routine is specified in the appropriate 
operand when the management program is generated. For example, in 
response to the 

DFHSG PROGRAM=SCP, * 

XTYPREQ=ORANGE 

specification, user exit linkage in the form of an Assembler 

BAL 14, ORANGE 

instruction is generated in the appropriate place in the Storage Control 
program. In this example, source code similar to the following should 
have been provided by the user in the member (book) DFHSCEXT: 



ORANGE DS OH 



USER EXIT ENTRY 



User code 



BR 



14 



Upon entry to a user exit routine, registers can be saved in the 
CSA register save area (CSAOSRSA) . The following example shows the 
use of OS/DOS SAVE and RETURN macro instructions to save registers 4 
through 6 and to use register 4 as a base register. 



ORANGE DS OH 

SAVE (4,6) 

BALR 4,0 
USING *,4 



USER EXIT ENTRY 

SAVE REGS 4,5,6 

IN CSAOSRSA 

USE REG 4 AS BASE REG 



RETURN (4,6) 



RESTORE REGS 4,5,6 
AND RETURN VIA REG 14 



Using the CSA for register saving is a non-reentrant method and 
therefore the exit routine should not issue any CICS or OS/DOS macro 
instructions that might reguire use of this CSA area. This includes 
releasing control to another task which might use this same (or another) 
exit routine that saves registers in the CSA. 

When creating the CICS management program assembly jobs during system 
generation, a COPY DFHxxEXT statement is included immediately preceding 
the Assembler END statement. In the above example, the following would 
be generated: 

COPY DFHCSADS 
COPY DFHTCADS 



COPY DFHSCP 
COPY DFHSCEXT 
END DFHSCNA 

When coding user exits for CICS management programs, the user should 
adhere to the following conventions and guidelines: 
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1. Since user exits are essentially "in line" with the management 
programs, the coder should be familiar with the functions of 
the program to which the exit code is being added. 

2. User-written exit routines must never alter the contents of 
registers that provide addressability to control blocks, unless 
the original contents are restored before return to the CICS 
management program. 

3. User-written exit routines must never violate restrictions of 
the management programs. For example, an exit routine in Storage 
Control cannot issue a DFHSC TYPE=GETMAIN macro instruction. 

In general, it is best if exit routines do not issues requests 
for CICS services. 

4. User-written exit routines must be coded in Assembler language. 

5. Symbolic names (labels) used to define user exit entry points 
must not be duplicates of labels in the CICS management program. 

6. Base register addressability for the user-written exit routine 
exists only to the extent of the base register (s) associated 
with the management program. The user exit must never alter 
the base register (s) of the management program. The user is 
responsible for saving registers and establishing addressability. 

7. Register contents differ depending on the management program 
and particular exit function. However, the contents of the 
following registers are always constant: 

REGISTER CONTENTS 

14 Return address 

13 CSA address 

12 TCA address 

Depending on the management program and functional user exit, certain 
general registers contain information that the user may find useful. 
The following is a summary, by exit, of the contents of these registers: 
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SYSGEN 








EXIT 






PROGRAM 


IDENT 


LINKAGE LOCATION 


REGISTE 


DFHKCP 


XDSPCHR 


Before dispatch 


TCACBAR 




XTYPREQ 


Before request 
analysis 


TXACBAR 


DFHPCP 


XFETCH 


After load 


PPTCBAR 
PCECREG 



DFHICP XICEEXP 

XTYPREQ 

DFHSCP XTYPREQ 

DFHTCP XATTACH 

XOUTPUT 

XINPUT 

DFHFCP XOUTPUT 

XINPUT 
XINPUTC 

XTYPREQ 

DFHTDP XOUTPUT 
XINPUT 
XYTPREQ 

DFHTSP XOUTPUT 
XINPUT 
XTYPREQ 



After expiration ICECBAR 
of time interval 

Before request N.A. 
analysis 

Before request N.A. 
analysis 

Before task attach TCTTEAR 

TCTLEAR 
TIOABAR 

Before output event TCTTEAR 

TCTLEAR 
TIOABAR 

After input event TCTTEAR 

TCTLEAR 
TIOABAR 

Before output event FWACBAR 

FCTDSBAR 

Before input event FCTDSBAR 

After input event FCTDSBAR 



Before entry 
Analysis 



FIOABAR 
N.A. 



Before output event DCTCBAR 

Before input event DCTCBAR 

Before request DCTCBAR 
analysis 

Before output event TSWKREG 

After input event TSWKREG 

Before request TSDA 
analysis 



Address of TCA beinq 
dispatched 
Address of TXA 
associated with task 
(CICS/DOSE only) 

Address of PPT entry 
for loaded program 
Entry point address 
of loaded program 

Address of Interval 
Control Element (ICE) 
just expired 
N.A. 



N.A. 



Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 



of TCTTE 
of TCTLE 
of TIOA 
of TCTTE 
of TCTLE 
of TIOA 
of TCTTE 
of TCTLE 
of TIOA 



Address of 
Address of 
for tarqet 
Address of 
for target 
Address of 
for tarqet 
Address of 
N.A. 



FWA 

FCT entry 
data set 
FCT entry 
data set 
FCT entry 
data set 
FIOA 



Address of DCT entry 
for tarqet destination 
Address of DCT entry 
for tarqet destination 
Address of DCT entry 
for target destination 

Address of data being 

read or written 

Address of data being 

read or written 

Address of data area 
specified by requestinq 
proqram 



N ot e: CICS provides a set of dummy exit members (books) as part of 
its distributed source library. These members contain only 
dummy labels and a BR 14 instruction, and should be replaced by 
user-written exit routines. 
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CREATING A TERMINAL ERROR PROGRA M (DFHTEP) 

The CICS terminal error handling structure is based on the assumption 
that most users will want to expand and refine certain CICS operations 
in response to various terminal errors. Since it is impossible for 
CICS to anticipate all courses of action, the error handling facilities 
have been designed to allow the user maximum freedom in providing unigue 
solutions for errors occurring within his terminal network. 

Three CICS components are involved in the detection and correction 
of terminal errors: 

1. Terminal Control program (DFHTCP) 

2. Terminal Abnormal Condition program (DFHTACP) 

3. Terminal Error program (DFHTEP) 

DFHTCP and DFHTACP are provided by CICS to perform certain basic 
detection and correction functions. DFHTEP is provided by the user 
who wishes to expand or alter the basic functions performed by DFHTCP 
and DFHTACP. A dummy DFHTEP is distributed with CICS containing only 
a DFHPC TYPE=RETURN macro instruction. 

TERMINAL ABNORMAL CONDITION LINE ENTRY (TACLE) 

When an abnormal condition occurs that is associated with a terminal 
or line, DFHTCP places the terminal out of service and dynamically 
creates a Terminal Abnormal Condition Line Entry (TACLE) which is 
chained off the real line entry on which the error occurred. The TACLE 
contains all the error information necessary for proper evaluation of 
the error, plus special action indicators that can be manipulated to 
alter the error correction procedure. 

DFHTACP is then attached by the Terminal Control program and provided 
with a pointer to the real line entry (TCTLE) on which the error 
occurred. After performing certain basic error analysis and 
establishing default actions to be taken, DFHTACP gives control to 
DFHTEP by issuing a DFHPC TYPE=LINK macro instruction. DFHTACP passes 
the TACLE to DFHTEP so DFHTEP can examine the error and provide an 
alternate course of action. 

Once the user has performed his desired function in DFHTEP, he should 
return control to DFHTACP by issuing a DFHPC TYPE=RETURN macro 
instruction. DFHTACP then performs the necessary actions as dictated 
by the action flags within the TACLE. 

When DFHTEP receives control from DFHTACP, the TCA Facility Control 
Address (TCAFCAAA) contains the address of a TACLE. The TACLE is 
created by the Terminal Control program when the error occurs and 
contains all the I/O error information provided by BTAM. 

To symbolically access the information contained in the TACLE, CICS 
provides two symbolic storage definitions (DSECT's) which can be copied 
into DFHTEP. These DSECT»s are DFHTACLE and DFHTCTLE. DFHTACLE 
describes the first twelve bytes of the TACLE which contain CICS error 
information; DFHTCTLE describes the remainder of the TACLE which 
contains a copy of the Data Extent Control Block (DECB) at the time 
the error occurred, plus other valuable information. 

To establish addressability to the TACLE, DFHTEP must provide, upon 
entry, the instruction: 

L TCTLEAR, TCAFCAAA LOAD TACLE BASE REGISTER 
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■where TCTLEAR is symbolically defined as the base register for the 
TACLE. If the user desires to access the real line entry in the TCT f 
its address is at location TCTLEECB within the TACLE. It is the user's 
responsibility, under these circumstances, to maintain addressablity 
between the TACLE and the real line entry. 

BFHTEF PROGRAMMING CONSIDERATIONS 

There are some situations in which CICS may attempt to send a message 
to an input cnly terminal. These might be, for example, an Invalid 
Transaction Identification message, an ATP batch count, or a message 
erroneously sent by an application program. The user should provide 
a Terminal Error Program (named DFHTEP) to re-route these messages to 
a system destination such as CSMT or CSTL or other destinations through 
the facilities of Transient Data or Interval Control. 

A simular situation exists when a message is sent to a 3735 terminal 
operating as an input batch device. An attempt to write to the 3735 
before the receipt of the End of Transmission (EOT) gives control to 
DFHTACP. If no EFHTEP is provided, the current transaction will be 
abnormally terminated and the line will be disconnected. 

The TACLE is the basic interface that should be used by user-written 
EFHTEP to determine the nature of the error that occurred and to 
indicate what course of action is to be taken. 

Before giving DFHTEP control, -DFHTACP establishes certain default 
actions tc be taken, depending upcn the error condition. Within DFHTEP, 
the user may choose to accept the default action under certain 
circumstances and alter the action under ether circumstances. To 
indicate that an alternate action is to be taken, the user must modify 
the action flags contained in the two-byte field of the TACLE labeled 
TCTLEECB+1 and TCTLEECB+2 (the second and third bytes in the DECB copy) . 

The default actions scheduled by DFHTACP before entry to DFHTEP are 
described in the following; the error code is found in the TACLE at 
TCTLEPFL. 



1 = Line cut of service 

2 = Terminal cut of service 

3 = Abend transaction 

4 = Switched line disconnected 

5 = Disconnect switched line 

6 = Release TCAM TIOA 



(X 


80' 


(X 


'08' 


(X 


04' 


(X 


20' 


(X 


10' 


(X 


80' 



at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+2) 



ERROR CODE 
(SYMBOLIC LABEL) 

X'81« (TCEMCMTL) 
X'82' (TCEMCTRL) 



X'84' (TCEMCTCT) 



CONDITION 

Input msg exceeds read length 
Translation error 
(TCT does not correspond to TCP) 

TCT search error 

a. Switched line - Real terminal 

b. Switched line - Dummy terminal 

c. Non-switched line 



ACTION SET 
BY DFHTACP 

3 
2 



X'85' (TCEMCROT) 



Invalid write reguest 

a. A write reguest was made to a 
terminal in INPUT status. 

b. A write reguest was made to a 
3735 before 'EOT' (EOF condition) 
was received from the 3735 during 
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ERROR CODE 
(SYMBOLIC LABEL) 



X»86« 
X'87» 



(TCEMCPL) 
(TCEMCUI) 



X'88« (TCEMCIER) 



X'89» (TCEMCSM) 



X»8A» (TCEMCTO) 
X^B' (TCEMCOBE) 

X f 8C» (TCEMCOER) 



X'8D» (TCEMCOLZ) 
X'8E» (TCEMCNOA) 
X'SE* (TCEMCOAE) 



X«9U« (TCEMCUC) 
X'95' (1CEMCUCS) 



CONDITION 

batch transmission. 

Polling list error 
Unsolicited input 

a. TCAM 

Terminal "Receive Only"; 
Terminal "Out of Service"; 
Task has not issued READ 

b. Input has occurred on an out- 
of-service terminal. (3735) 

ETAM return code on read 

a. Local 3270 open failure. 
Invalid RLN, unreliable 
information (DOS) , device 
under OPTEP 

b. All other conditions 



ACTION SET 
BY DFHTACP 



6 
2,6 





2,3 



1,3 



Error status received frcm remote 3270*s. 

a. 3270 operation check 3 

b. 3270 intervention required 

c. 3270 all other conditions 2,3 

d. 3735 all conditions 

7770 32-second timeout 3,5 

Hardware buffer exceeded (shift 3 

character net properly accounted for) 

BTAM return cede en write 

a. Local 3270 open failure, 2,3 
Invalid RLN, unreliable 
information (DOS) , device 

under CLTEP 

b. All other conditions 1,3 

Output length zero 3 

No output area provided 3 

Output area exceeded (TIOATDL 3 
value larger than output area) 

Unit check (actions same as TCEMCUCS) 
Unit check (should not occur) 

a. Not ETAM line or L3270 1 

b. Switched line disabled (CICS/OS) 4 
in combination with following: 

Intervention sense 

c. Switched line 3,4 

d. Dummy terminal 1 

e. Non-switched line 2,3 

Data check sense 

f. Real terminal 2,3 

g. Dummy terminal 1 

Timeout sense 

h. READ text command/Start-Stop device 

i. Real terminal 2,3 

j. Dummy terminal 1 

All other sense 1 
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ERROR CODE ACTION SET 

(SYMBOLIC LABEL) CONDITION BY DFHTACP 

X»96' (TCEMCUE) Unit exception (actions same as TCEMCUES) 

X»97' (TCIMCUES) Unit exception (should not occur) 

a. Switched line 3,4 

b. Real terminal 2,3 

c. Dummy terminal 1 

X'98' (TCEMCNR) Negative response to addressing 2 r 3 
x iggi (TCEHCUDT) Undetermined unit error 1,3 

X»9B' (TCEMCICR) The terminal entries on the 'to' 3 

and 'from 1 device did not specify 

the COPY feature (3270) . 

The device address specified for 
the 'to 1 device does not exist 
on the control unit. 

The length of the COPY command 
was not specified as one. 

X'90 1 (TCEMCIMB) Invalid message block received. 

a. An unidentified message block 2,3 
was received from a local or 

remote 3270. 

b. The type of input block received 2,3 
from a 3735 did not agree with 

the mode of the active transac- 
tion inguiry/batch. 

X»9D' (TCEMCICM) An incomplete message was received 2,3 

from a remote 3270. The device 
terminated transmission prior to 
message completion (that is, EOT 
received prior to ETX) . 

X«9fi (TCEHIDE) TCAM has issued an invalid destin- 3 

aticn return code to CICS. 

X«A0» (TCEMCHOT) Invalid Read reguest: 

a. A Read reguest was issued to a 3 
terminal in RECEIVE status. 

b. A Read was issued to a 3735 3 
terminal after EOT (EOF condition) 

was received from the terminal 
during batch transmission. 

X'A1" (TCEMCIDR) A transaction has reguested a DEHTC 

TYPE= (RESET, DISCONNECT) on a switched 
binary synchronous line and no EOT has 
been received from the terminal; 
this indicates more data is to 
fellow. Terminal Control issues 
a read to the terminal if an EOT has 
been received. If the EOT is not 
received on that read, the error 
code is set and passed to DFHTACP. 

Following is a diagram of the Terminal Abnormal Condition Line Entry 
(TACLE) which is pointed to by the TCAFCAAA field upon entry to DFHTEP: 
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TERMINAL ABNORMAL CONDITION LINE ENTEY 

Dec. Hex.* < 4 BYTES >* 

* * 
o ***************************************************** 

* TCTLEPSA * 

* * 

* STORAGE ACCOUNTING AREA * 
4 4 * * 

* TCTLEPCH * 

* * 

* ADDRESS OE TRANSIENT DATA OUTPUT AREA * 
8 8 * * 

* TCTLEPFL * TCTLEPF2 * TCTLEPTE * 

* * * * 

* ERROR FLAGS * SPECIAL IND * TCTTE DISPLACEMENT * 
C C * * 

* TCTLEECB * * * BTAH * 

* BEGINNING * ACTION * RESERVED * RETURN * 

* OE EECB * FLAGS *FOR DFHTACP* CODE * 
16 10 * * 

* * 

* NOT USED * 

* * 

20 14 * * 

* TCTLEDCB * 

* * 

* ACTUAL LINE ENTRY ADDRESS * 
24 18 * * 

* * 

* NOT USED * 

* * 

UQ 28 * * 

* * TCTLECSW * 

* NOT USED * * 

* * BSAM STATUS * 
44 2C * * 

* TCTLEALP * * 

* ESAH * NOT USED * 

* SENSE * * 

***************************************************** 



Displacement 
Degj. Hex.. Code Bytes Label Meaning 

4 TCTLEPSA Storage accounting 

4 4 4 TCTLEPCH Pointer to 100 bytes of user 

storage that can be used to 
write to Transient Data. 
This storage must not be 
freed by DFHTEP, as DFHTACP 
may reuse it. 

8 8 1 TCTLEPFL Error flags 

81 Input error 

82 Translation error 

84 TCT search error 

85 Invalid write 
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Displacement 
5££i Hex. Code Bytes Label Meaning 

86 Polling list error 

87 Unsolicited input 

88 Input event rejected 

89 Status message received 
8A 7770 32-second timeout 
8B Hardware buffer exceeded 
8C Output event rejected 

8D Output length of zero 

8E No output area 

8F Output area exceeded 

94 Unit check 

95 Unit check (should not occur) 

96 Unit exception 

97 Unit exception (should not 

occur) 

98 Negative response 

99 Undetermined I/O error 
9B Copy error (3270) 

9C Invalid message block 

9D Incomplete message 

9F Invalid TCAM destination 

A0 Invalid read 

A1 Invalid disconnect 

(All codes not listed are reserved) 

9 9 1 TCTLEPF2 Special indicator 

01 Dummy terminal 

10 A 2 TCTLEPTE Displacement from line 

entry to terminal in error 

12 C 48 TCTLEECB DECB/copy of line when 

error occurred 

Following is the definition of the action bits (0,3,4,5,6 and 7) 
and information bits (1 and 2) and is the only portion of the copy of 
the DECB that can be altered. They are located at label TCTLEECB+1. 

In the second interface byte (TCTLEECB+2) , bit is used to process 
TCAM unsolicited errors. Upon entry to TEP if this bit is set for 
unsolicited input, it indicates that the data is destined for a terminal 
entry that is either Out of Service or in Receive Only status. If not 
set in this manner, the terminal entry for which the data is destined 
has a task which has not issued a READ request. Upon entry to TEP, 
this data is on the Input Queue Terminal Entry storage chain, and is 
located by label TCTLEIOA in the TACLE. Upon return to TACP from TEP, 
this bit (if set) is used to free unsolicited data or to allow another 
time delay cycle if not set. 

Dec.;. Hex^ Bytes Label Meaning 

13 D 1 TCTLEECB+1 Interface byte 

Bit Place line in service 

1 Place line out of service 

Bit 1 Information Bit 

. Not used 

.1 Non purgeable task exists 
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Dec, 



Hex. 



Byt es Label 



14 



15 


F 


20 


14 


42 


2A 


44 


2C 



Bit 2 

Bit 3 
Bit 4 
Bit 5 
Bit 6 



Bit 7 



Bit 



Bit 1-7 



.1 



.. 

1 .. 

0. 

1. 

.0 

.1 

..0 



• ••• •• I « 



Mean ing 

on terminal 

Information Bit 

Not used 

Switched line has been 

disconnected by BTAM 

Do not disconnect line 

Disconnect line 

Place terminal in service 

Place terminal out of service 

Do not abend task 

Abend task 

Leave terminal's associated 

control unit on poll list 

Take terminal's associated 
control unit off poll list 

Do not abort WRITE or 
free terminal storage 
on task abend or no task 
present on terminal 

Abort terminal WRITE 
requests and free terminal 
storage on task abend or 
no task present on terminal 



TCTLEECB+2 Interface byte 2 



1 


TCTLEECB+3 


4 


TCTLEDCB 


2 


TCTLECSW 


1 


TCTLEALP 



Do not release TCAM TIOA 
Release TCAM unsolicited 
input TIOA 

Reserved 

BTAM return code 

Actual line entry address 

BSAM Status 

BSAM Sense 



The following factors should be considered when altering the action 
bits in the TACLE: 

1. If the "task abend" flag is set by DFHTACP (X'04' at TCTLEECB+1) , 
the "non-purgeable" flag (X'40') is also set if the task is 
non-purgeable. 

2. If the "task abend" bit is on upon return to DFHTACP from DFHTEP 
and a non-purgeable task exists on the terminal, the terminal 

is placed out of service and the task remains attached to the 
terminal. 

3. If a dummy terminal is indicated (X'OI 1 ) at TCTLEPF2, a 
disconnect request from DFHTEP is not honored by DFHTACP. (A 
dummy terminal is created whenever an error occurs on a terminal 
whose address does not exist in the TCT.) 

4. The "switched line disconnected" bit is used by DFHTACP upon 
return from DFHTEP to logically disconnect the switched line 
that has been physically disconnected. If DFHTEP determines 
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that the line has not been physically disconnected, DFHTEP may 
reset this bit. 

5. If the "switched line disconnected" bit or the "disconnect 
switched line" bit is on, upon return from DFHTEP, the "task 
abend" bit should also be set to purge the task from the 
disconnected terminal. If this is the case and if the task is 
not terminal purgeable, DFHTACP writes an INTERCEPT REQUIRED 
message to destination CSMT and places the terminal out of 
service. 

6. The dummy terminal indicator at TCTLEPF2 is set on errors such 
as: (1) BTAM return on input, (2) binary synchronous outputs 
performed for TCP where no terminal is indicated, and (3) other 
errors where no terminal error conditions are indicated. 
Therefore, if Dummy Terminal is indicated, task abend and write 
abort are not set. The Dummy Terminal is only used to identify 
the line. 

7. The write abort bit (bit 7 at TCTLEECB+2) is always set with 
task abend reguest in TACP as a default. Upon return from TACP, 
the write abort bit is used as follows: 

a. Causes the Terminal Control write reguests to be aborted. 

b. If the task is being abended and is terminal purgeable 
or task exists on the terminal, the Terminal Storage 
will be freed. 

The following is an example of the logic steps necessary to design 
a portion of the Terminal Error program. In this example ten retries 
are provided per terminal; however, the logic could be used for any 
number of retries. The following assumptions are made: 

USER FIELD A Represents a six-byte field in the Process Control 

(PCISAVE) Information (PCI) area of the TCTTE (see the TCT macro 
definition of the TCTUAL operand) . This field is used 
to preserve the count of input and output from the TCTTE 
when the first error occurs. These counts are contained 
in three-byte fields located at TCTTENI and TCTTENO 
within the TCTTE. 

USER FIELD B Represents a user-defined field used to 

(PCICNT) accumulate the count of recursive errors. It would most 
likely be in the Process Control Information (PCI) area 
of the TCTTE. 

SYSTEM COUNT Represents the six-byte field in the TCTTE that contains 
(TCTTENI) the terminal input and output counts (TCTTENI+TCTTENO) . 
In the example, these two adjacent fields are considered 
as one six-byte field. 

Since this example reguires access to the TCT terminal entry (TCTTE) 
to examine the SYSTEM COUNT and to also locate the Process Control 
Information (PCI) area, the DFHTCTTE symbolic storage definition is 
included so fields may be symbolically referenced. 

******************************************************************** 

* * 

* DFHTEP RECURSIVE RETRY ROUTINE * 

* * 
************************************************************************ 
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TEPBAR 

TCTTEAE 

PCIBAE 



PCIAREA 
PCISAVE 
PCICNT 

DFHTEP 



EQU 2 

EQU 9 

EQU 8 

COPY DFHTCTTE 

EJECT 

COPY DFHTACLE 

COPY DFHTCTLE 

EJECT 

DSECT 

DS 6X 

DS PL2 

EJECT 

CSECT 

BALE TEPBAR, 

USING *, TEPBAR 

L TCTLEAR,TCAFCAAA 

L TCTTEAR,TCTLEDCB 



AH 



TCTTEAR,TCTLEPTE 



RESET 
INCR 



L PCIBAR,TCTTECIA 
USING PCIAREA,PCIBAR 
TM PCICNT+ljX'OC 1 



30 



AP 



NORETRY DS 



CKCOUNT 



MVC PCICNT, =PL2«+0' 
MVC PCISAVE (6) ,TCTTENI 



PCICNT, =P» 1' 





CP 


PCICNT, =P« 10' 


* 








BNE 


RETRY 


* 








ZAP 


PCICNT, =P'0' 




MVC 


PCISAVE(6) ,TCTTENI 




B 


NORETRY 


CKCOUNT 


CLC 


PCISAVE (6) ,TCTTENI 


* 








BNE 


RESET 


* 






* 






* 








B 


INCR 


* 






* 






* 






RETRY 


DS 


OH 



OH 



TEP PROGRAM BASE 

BASE REGISTER FOR TCTTE 

BASE FOR PCI 

COPY TCTTE DEFINITION 

COPY TACLE SYMBOLIC DEFINITIONS 
COPY DECB DEFINITION 



USER FIELD A 
USER FIELD B 



ESTABLISH PROGRAM ADDRESSABILITY 

LOAD TACLE ADDRESS 
LOAD TCTTE BASE WITH 
REAL LINE ADDRESS 
INCREMENT BASE BY THE 
TCTTE DISPLACEMENT. THIS 
GIVES ADDRESSABILITY TO TCTTE. 
LOAD PCI AREA ADDRESS 
ESTABLISH ADDRESSABILITY 
HAS USER FIELD B EVER BEEN 
INITIALIZED TO A PACKED 
DECIMAL NUMBER? 
.. YES, SO COMPARE THE 
SYSTEM COUNT WITH THE 
EXISTING COUNT IN FIELD B; 
.. NO, SO INITIALIZE FIELD 
B TO A PACKED DECIMAL 0. 
SAVE THE CURRENT SYSTEM 
COUNTS. THIS IS A NEW 
ERROR, OR FIRST TIME THROUGH 
INCREMENT THE NUMBER OF 
TIMES THIS SAME ERROR HAS 
OCCURRED. (RECURSIVE COUNT) 
HAS THE MAXIMUM RECURSIVE 
ERROR LIMIT BEEN REACHED? 
.. NO, SET ACTION 
INDICATORS FOR RETRY ATTEMPT 

* CLEAR AND RESET USER FIELDS 

* FOR NEXT ERROR SET 

ACTION INDICATORS FOR NO-RETRY. 

HAS SYSTEM COUNT CHANGED SINCE 

LAST ENTRY TO TEP? 

.. YES; THAT MEANS THIS IS 

A NEW ERROR SINCE SOME I/O 

ACTIVITY HAS OCCURRED ON 

TERMINAL 

.. NO; THAT MEANS THIS IS A 

RECURSIVE ERROR, SO 

INCREMENT THE RECURSIVE COUNT 

AND CHECK FOR RETRY. 

THE USER WOULD INCLUDE HERE 

THE CODE NECESSARY TO ALTER 

THE FLAGS IN THE TACLE SO 

THAT A RETRY CAN BE PERFORMED 

ON THE TERMINAL. 

THE USER WOULD INCLUDE HERE 

THE CODE NECESSARY TO ALLOW 

DFHTACP TO TAKE FINAL ACTION 

ON THE TERMINAL (I.E., ABEND TASK, 

PUT LINE OUT OF SERVICE, ETC.) 
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The above example is intended only to serve as an illustration of 
a recursive error handling technique and the steps necessary to 
establish addressability to the applicable control blocks. 

DFHTEP ALTERNATE INTERFACE (CICS/OS only) 

An alternate interface is provided in the CICS/OS-STANDARD system 
for the purpose cf maintaining compatibility with the CICS/OS-STANDARD 
Version 1 user who currently has code dependent upon this interface. 
This interface is provided when the user specifies V1CMPAT=YES in the 
DEHSG TYFE=CSO macro instruction during system generation. 

Upon detection of an error, control is passed to DEHTEP for analysis; 
the TWA contains the following information: 

BYTES LABEL DEFINITION 

1 TWACOEA Contains the status byte from BTAM 

1 TWACOBA+1 Contains the sense byte from BTAM 

1 TWACOBA+2 Contains the teleprocessing OP code 

being issued 

1 TWACOEA+3 Reserved 

4 TWACOBA+4 Contains the transaction ID if one exists 

for the terminal in error 

User-written EFHTEP must place the line or terminal in service or 
cut of service if so desired. If the task is to be abended, DFHTEP 
must place a X'FE* at label TWACOEA before returning control to DFHTACP. 

7770 32-SECOND TIMEOUT CONSIDERATIONS 

If a terminal connected to the 7770 Audio Response Unit goes "on 
hook" while no I/O operation is outstanding, the 7770 does not present 
the unit exception to the channel. This situation can occur when the 
terminal operator makes an inguiry and hangs up before receiving a 
response. After this occurs, all writes to the line appear to complete 
normally. All reads complete normally at the end of the 32-second 
timeout with a zero data length. 

When a 32-second timeout occurs, either the terminal operator has 
not entered anything for 32 seconds, or the terminal operator has hung 
up and the 7770 did not inform CICS. CICS cannot distinguish between 
these two conditions; therefore, CICS handles every 32-second timeout 
as an error condition. DFHTACP goes to DFHTEP with defaults of 
DISCONNECT SWITCHED LINE and ABEND THE TRANSACTION. If DFHTEP does 
not disconnect the switched line, CICS writes the "ready" message and 
initiates another read. 

2740 MODEL 2 CONSIDERATIONS 

When DFHTACP detects a negative response from a 2740 Model 2, the 
write operation will be retried after a 26.64 second time delay. This 
delay allows for operator reaction time etc. If the delay time factor 
is to be changed it may be done by storing the new time delay factor 
at TCTTEBC. The value is a positive binary number representing 
hundredths of seconds, (10 seconds would be a value of F*1000' or 
X» C00003E8') . The cause of the negative response may be determined by 
examining the field TCTLERSP. 
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Contents of TCTLEBSP meanings are as follows: 

X'04 1 Terminal in bid mode 

X , 02' Terminal in communicate mode 

X'20' Terminal in communicate mode with document device down 

X'10' Terminal in local mode 

XM3' Terminal in communicate mode but out of paper 

X'OS 1 Contents of buffer are being printed. 

Caution: Failure to set a time delay of a sufficiently large value 

may cause a loop at the terminal wherein pressing the reset 
key will not be recognized. 

SJIIING A TRANSACTION TO IPL THE SYSTEM/7 

To initial program load (IPL) the System/7 from ClCS r the user must 
write a transaction that issues an automatic transaction initiation 
reguest to either Interval Contrcl or Transient Data Control. This 
transaction is usually initiated from the master terminal or from a 
seguential terminal. The initiated transaction is started on the 
System/7; it then writes the IPL records to the System/7. 

The IPI records are prepared by the user and consist of: 

1. UZERO, a utility module 

2. UTIPL, a utility module 

3. System/7 storage load 

UZERO and OTIEL are provided in object deck form on the MSP/7 
distribution tape under member names CAAUZERO and CAAUTIPL, 
respectively. If link edited into the user-written application program, 
UZERO and UTIPL are available for transmission in a suitably translated 
format. 

The first two bytes of each of these modules is a count of the number 
of characters in the remainder of the module. These two bytes must be 
placed in the user's TIOA at TIOATDL by the application program. The 
remainder of the module is moved to TIOADBA. UZERO and UTIPL may then 
be transmitted to the System/7 by issuing the DFHTC TYPE= (WRITE, WAIT) 
macro instruction in the application program. 
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The System/7 storage load is generated using the TELETRANS option 
_f the MSP/7 Output Handler. The storage load is comprised of 
80-character records that may be read via the Transient Data or File 
Contrcl facilities of CICS and transmitted to the System/7 by issuing 
a series of DFHTC TYPE= (WRITE, WAIT) macro instructions. If a DFHPC 
Type=Return macrc instruction is used to allow the System/7 to begin 
execution, the user must ensure that no automatically initiated 
transaction is scheduled to begin on the System/7 until at least 10 
seconds have elapsed following execution of the DFHPC Type=Return macro 
instruction. 

For more informaticn concerning the preparation of Ipl records for 
the System/7, see the publication Modular System Programs (MSP/7) 
Sio^rajimincj Guide (GC34-0013) . 

2260 COMPATIBILITY FOR THE 3270 

2260-compatibility support for the 3270 Information Display System 
allows the user to run his currently operational 2260-based transactions 
frcm a 3270. 
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During CICS system generation, the user must request 2260 
compatibility to be included, thereby generating the necessary code to 
provide conversion of 2260 data streams from user-written application 
programs to the appropriate 3270 data stream format. when the 3270 
operates with a "compatibility" transaction, incoming data from the 
3270 is converted and presented to the user-written application program 
in 2260 format. In most cases, no changes are required to the 
user-written program. 

Because 2260 compatibility is specified by transaction as well as 
by terminal, non-2260-based transactions have full access to all 
facilities of the 3270. Only when a 2260-compatible transaction is 
attached to a 2260-compatible 3270 does CICS perform the editing of 
the input and output data streams. If the transaction is not specified 
as 2260 compatible, or if the terminal is not specified as supporting 
2260 compatibility, no editing occurs for the data streams. In that 
case, if the data streams are not valid 3270 data streams, the results 
are unpredictable. 

Two modes of compatibility operation are provided: FCRMAT and 
FULLBUF. 
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FORMAT mode takes full advantage of the 3270 formatting and data 
compression facilities, and is the preferred method of 2260 
compatibility, particularly for the operation of remote 3270 , s. 
However, some 2260 facilities cannot be supported under FORMAT mode. 
For information concerning which facilities are available, see the 
discussion under the topic "Screen Techniques". 

FULLBUF mode does not use the 3270 data compression facilities and 
must therefore be used when all lines of input data are desired. For 
each operator interaction involving a data entry key (ENTER, PF1 - 
PF12) , the number of characters transferred is approximately equal to 
the total number of characters on the simulated 2260 screen. The exact 
number of characters transferred varies depending upon whether the 3270 
is local or remote and which model of the 2260 is being mapped onto 
which model of the 3270. 

Note : A terminal is considered to be in compatibility mode from the 
time a 2260-compatible transaction is initiated until (1) the 
CLEAR key is depressed, or (2) a 3270 native mode transaction 
is initiated. 

For local 3270 operation, the extra data transfer of FULLBUF mode 
should be transparent to the user with regard to response time. For 
remote 3270 operation, the response time is a complex function of the 
present method of 2260 operation and the line speeds used for the 2260 
and 3270; however, the increase in the response time (on a transaction 
basis) should be less than 20% at the same line speed. 

CICS TABLE PREPARATION FOR 2260 COMPATIBILITY 

Individual transactions can be flagged for FORMAT or FULLBUF 2260 
compatibility through the DFHPCT TYPE=ENTRY macro instruction. The 
mode of compatibility chosen depends on the 2260 functions required 
for the application programs that run under this particular transaction 
code. 

The characteristics of the 2260/2265 terminal (which the 3277/3275 
replaces) are specified by additional operands for the DFHTCT 
TYPE=TERMINAL macro instruction. They are as follows: 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT,SELCTPEN r AUDALARM,COPY,BUFEXP, * 
DCKYBD,UCTRAN) 

The "number of characters" parameter is used to specify the screen 
size of the 2260/2265 terminal. Applicable parameter values are 240, 
480, and 960. 

The "number of lines" parameter is used to indicate the number of 
lines applicable to the 2260/2265 terminal or to insert new line (NL) 
symbols into the 3284/3286 printer output data stream where NL symbols 
are not provided by the user in the output data stream. Applicable 
parameter values are 6, 12, and 15. The default value for a 
960-character screen is 12. 

The "device type" parameter is used to specify a 2260 or 2265 
terminal or a 1053 printer. The default is 2260. Note that the 
specification COMPAT= (960, 15) results in an error condition since the 
2260 (assumed by default) cannot support 15 lines. 

The "model number" parameter is used to specify a model number for 
the 2260 terminal being simulated. This parameter provides an interface 
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for any user-written application programs that currently test the 
TCTTETH field before building device-dependent 2260 data streams. 

The FEATURE operand has been included in the CICS DFHTCT 
TYPE=TERMINAL macro instruction to indicate the presence of 3270 
Information Display System features (for example. Printer Adapter, 
Selector Pen, Audible Alarm, Copy feature, Buffer Expansion, uppercase 
translation, dual case keyboard) and to specify the corresponding 3284 
Model 3 Printer on the 3275 Display Station. 

Note: A separate DFHTCT TYPE=TERMINAL macro instruction cannot be 
coded for the 3284 Model 3 Printer because the 3284 Model 3 
shares the buffer of the 3275 Display Station. 

2260 MODEL-DEPENDENT DATA STREAM 

Some users require the capability of building 2260 device-dependent 
data streams. CICS allows the user to build such data streams by 
providing the terminal type at TCTTETT in the Terminal Control Table 
(TCT) and the terminal model number at TCTTETM in the TCT. 

The TCTTETT and TCTTETM fields always contain the 2260 or 226 5 
terminal type codes and user-assigned model number (as specified in 
the DFHTCT TYPE=TERMINAL macro instruction) whenever a transaction 
flagged for CICS 2260 compatibility is dispatched. At all other times, 
TCTTETT and TCTTETM contain the codes for the 3270 terminal. 



SCREEN TECHNIQUES 

Various techniques have been used for entering data using a 2260 
screen and keyboard. The following are examples of four basic 
techniques that may be used. 

1. Formatted 2260 screen technique; for example: 



► USER KEYED DATA X* 

X X A 

X XA 



-XA 



-XA 



X-CONSTANT DATA X 
X X 



With this technique, the constant data is optional and is sent 
to the user at the start of the transaction. Either FORMAT or 
FUILBUF mode may be specified, depending upon the user's 
formatting reguirements. 
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2. 2260 tab feature technique; for example: 

► NAME: INITIAL: 

STREET: NUMBER: 

CITY: STATE: 

For CICS 2260 compatibility operation, the colon-tab character 
combination is replaced by 3270 "unprotected attribute" 
characters. FORMAT mode may be specified if data is always 
keyed into every field. FULLBUF mode must specified if any 
field is to be left blank. (Unlike the 2260, the 3270 does not 
transmit blank characters unless FULLBUF is specified.) If 
FULLBUF is not specified, any heading following the blank field 
is not transmitted to the application program. 

► NAME: JONES INITIAL: J* 
STREET: NUMBER: 1515* 

CITY: NEW YORK— STATE: 

FORMAT data stream: 

NAME:J0NES INITIAL: J(NL) :1515(NL) :NEW YORK 



FULLBUF data stream: 

NAME:J0NES INITIAL.-J(NL) STREET: NUMBER: 1 51 5(NL) CITY:NEW Y0R. 

3. "Endless screen" technique; for example: 

X NEW DATA* X 

X _ x 

X OLD DATA X 



x- 






X" 






X 


► NFW nATA 


A 



X 
X 

With this technique, the 2260 screen is treated as unformatted. 
The operator keys off the screen, and, wrapping around to the 
start of the screen, overkeys any old data still there. The 
2260 transmits a data stream delimited by SMI (start of message) 
and EOM (end of message) characters, irrespective of any screen 
wraparound. 

Either FORMAT or FULLBUF can be specified. In either case, CICS 
ensures that the data stream is correctly ordered before sending 
it to the 2260-based transaction. 

With this technique, there is a difference in operation between 
FORMAT and FULLBUF modes only in the case of a 480-character 
2260 mapped onto a 480-character 3270. Use of FORMAT mode causes 
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4. 



the loss of the last character of every 2260 output line. Use 
of FULLBDF mode limits the data loss to the last character 
position of the last line but at the expense of transferring a 
full 480 characters (479 characters plus one attribute character) 
for each interaction involving a data entry key. 

It is the responsibility of the user to determine whether his 
2260 transaction can tolerate the loss of the last character of 
each output line. CICS appends a blank character to the end of 
each 2260 input line, except where the line is terminated 
prematurely by a new- line (NL) symbol. 

"Change and enter" technique; for example: 

► JONES J H 

1515 OLD ROAD EAST ORIGINAL 

NEW YORK I RECORD 



10010 



► JONES 
1515 

NEW YORK 
N. Y. 10010 



J H 

OLD ROAD WEST 



UPDATED 
RECORD 



The FORMAT data stream looks like this: 

JONES J H 1515 OLD ROAD WEST 

The FULLBUF data stream looks like this: 

JONES J H 1515 OLD ROAD WEST 
NEW YORK N.Y. 10010 

The 2260 transaction sends an existing record to the screen. 
After making any necessary corrections to data fields, the 
operator depresses the ENTER key; the 2260 transaction receives 
the entire record in its updated version. 

With this technique, FULLBDF must be specified for this 
transaction to ensure that the transaction receives a 
2260-compatible data stream. 
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START OF MESSAGE INDICATOR (SHI) 

For the 2260, X«4A' is displayed as the SMI (►) character. If the 
SMI character is contained in an output data stream, it is displayed 
on the 3270 screen as follows: 

COUNTRY SMI SYMBOL 

U.S.A. * 

U.K. $ 

France * or c 

Germany o 

At the user's discretion, a different character may be specified 
during CICS system generation to represent the SMI. Whatever character 
is chosen, it remains the same for all transactions. 

If an SMI character is not placed on the screen by the user's 2260 
data stream, the operator must then key an SMI character somewhere on 
the screen. Failure to do so results in no data being transmitted to 
the application program. 

After the data has been read in, CICS 2260 compatibility transmits 
a single blank character to overwrite the SMI character. 

NEW LINE SYMBOL (NL) 

For CICS 2260 compatibility, the new line (NL) function is replaced 
by a field mark character followed by the NL key. Any incoming field 
mark characters are treated as 2260 NL characters, and the remainder 
of the line is discarded. 

Including the NL symbol in the 2260 output data stream causes the 
substitution of a 3270 field mark character; the output continues at 
the beginning of the next line. (The 3270 field mark character displays 
as a semicolon.) 

LINE ADDRESSING 

For a 3270 operating under CICS compatibility, any requests for 
write at line address are honored. CICS 2260 compatibility converts 
the line address to the equivalent 3270 buffer address before 
transmitting the data stream to the screen. 

2848 LOCK FEATURE 

The optional lock feature available on the 2848 Display Control 
Models 21 and 22 is supported by CICS 2260 compatibility. Any read/lock 
reguest is honored by CICS 2260 compatibility by leaving the 3270 
keyboard inhibited. The keyboard is reset only if the transaction 
changes or if a WRITE macro instruction is issued by the application 
program. 

2845/2848 TAB FEATURE 

The optional tab feature available on the 2845/2848 Display Control 
is supported by CICS 2260 compatibility. Any tab character (colon) 
found in the output data stream is replaced by an attribute byte. This 
attribute byte is converted back to a 2260 tab character on a read 
operation. 
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Because the tab feature uses an attribute byte, the terminal operator 
cannot key a tab character from the keyboard. The tab does not display 
on the screen, but is present in the user's input data stream. 

For proper operation, transactions using the tab technique are 
required to operate in FULLBUF mode. A tab character should not be 
inserted as the last character of a line. 

Because the tab feature uses an attribute byte, the cursor stops at 
the beginning of each line before stopping at the authorized attribute 
position, except in the case of U80/U80 FULLBUF conversion. The cursor 
stops only at the authorized attribute position and the last position 
in the buffer. 



INITIATING TRANSACTIONS 

The terminal operator can initiate either 2260 compatibility or 3270 
native mode transactions by entering the appropriate four-character 
CICS transaction code. While in compatibility mode, any Start of 
Message Indicator (SMI) character in the input data stream is recognized 
by CICS; the succeeding four characters are interpreted as a CICS 
transaction code. The transaction code must be contiguous and may not 
span two fields. 

CICS then initiates the specified transaction. If the specified 
transaction is a 2260 compatibility transaction, CICS automatically 
formats the 3270 screen. 

To allow easy transition between 2260 compatibility and 3270 native 
mode transactions, some conventions should be followed. Three 
acceptable methods of transition between transactions are: 

1. Clear the screen; then enter the transaction code and any data 
to be presented to the transaction. 

In this case, the operator must enter the transaction code at 
the first position of the screen. The transaction code may be 
preceded by the SMI character, in which case the next four 
characters are interpreted as the transaction code. A 
transaction code may not contain an SMI character. 

2. For a terminal in compatibility mode, enter the SMI character, 
the transaction code, and data. If the transaction to be 
initiated is a compatibility transaction, all data from the SMI 
character to the cursor position is treated as a 2260 
compatibility data stream and is mapped into 2260 format. For 
a native mode transaction, the data stream is identical with 
the data stream from an unformatted screen buffer. 

3. For a terminal in native mode with a formatted screen, the SMI 
character and transaction code must be the first data characters 
in the data stream. If the transaction code calls for a 
compatibility transaction, the screen is formatted for 2260 
compatibility but no data is presented to the transaction. 

4. Always clear the screen before initiating a CICS transaction. 
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3735 PROGRAMMING CONSIDERATIONS (Not applicable to CICS/DOS-ENTRY) 

SYSTEM GENERATION 

BTAMDEV=3735D and ANSWRBK=EXIDVER must be included in the DFHSG 
PROGRAM=TCP macro instruction during system generation if support for 
the 3735 Programmable Buffered Terminal is to be generated for switched 
lines. 



TERMINAL CONTROL TABLE PREPARATION 

FEATURE=AUTOANSR must be specified in the DFHTCT TYPE=LINE macro 
instruction for all terminals on switched-line networks. To support 
the 3735 Programmable Buffered Terminal, the following must also be 
specified: 

1. DFHTCT TYPE=LINE,ANSWRBK=EXIDVER. 

2. BTAM DFTRMLST macro instruction of the form: SWLST,AN; the user 
portion of each 3735 DFTRMLST entry must point to the 
corresponding TCTTE. 

3. DFHTCT TYPE=TERMINAL,TRMTYPE=3735. 

If FEATURE=AUTOCALL is specified in the DFHTCT TYPE=LINE macro 
instruction, the following must also be specified: 

1. BTAM DFTRMLST macro instruction of the form: SWLST,AD. 

2. DFHTCT TYPE=TERMINAL,TRMADDR=name, and for batch input, 
TRANSID=name. 



INQUIRY MODE 

CICS deletes the inquiry header on input and inserts it on output, 
Therefore, inquiry applications require that: 

1. A single output record is transmitted. 

2. The output block does not exceed 233 bytes (plus a three-byte 
inquiry header) . 

3. The output data stream does not contain characters which are 
invalid for a 37 35. (See the 373 5 Programmer 's Guide, 
GC30-3001.) 

If multiple inquiries are required in a single connection on a 
switched line, the user must make provision in his DFHTEP program to 
keep the line open. To accomplish this he may check for the IOERROR 
- TIMEOUT condition, a WRITE TR or READ TQ instruction, and TCTTEMIQ 
set to a hexadecimal blank character (X'UO 1 ) in TCTTEMCI. 



CICS/TCAM INTERFACE CONSIDERATIONS 



Most independent teleprocessing applications require a dedicated 
network. The Telecommunications Access Method (TCAM) permits multiple 
applications to share a single network, resulting in more efficient 
use of terminals and lines. The CICS/TCAM Interface enables CICS to 
run as an application under TCAM. 

TCAM is an optional access method that may be used alone or in 
combination with other access methods currently supported (BTAM, BSAM, 
and BGAM) . 
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One practical use of the CICS/TCAM Interface is to run a "production" 
CICS in one region and a "test" CICS in another. Running in separate 
regions, the applications are protected from one another. Operating 
under TCAM, terminals and lines can be shared by the two CICS 
applications. Other TCAM applications such as the Time Sharing Option 
(TSO) can also be running concurrently. 

In most cases, CICS user tasks that run under BTAM can run under 
TCAM without modification to the task code. This assumes that the user 
has properly designed and coded his TCAM Message Control program (MCP) . 
Modifications to his CICS Terminal Error program (DFHTEP) are required 
to take advantage of the new error codes used in the CICS/TCAM 
Interface. 

There are basic differences between TCAM and BTAM design methods. 
CICS was designed to operate in the BTAM environment. The CICS/TCAM 
Interface, although resolving most of the differences, must impose some 
restrictions when CICS is run in a TCAM environment. These restrictions 
as well as some of the ramifications of selecting various user options 
are addressed in this section. Also described are the user facilities 
available and how the user implements and operates his system via the 
interface. 



TCAM APPLICATION PROGRAM INTERFACE 

The TCAM Application Program Interface is a portion of the TCAM 
Message Control program (MCP) . It consists of two types of control 
blocks, the Process Control Block (PCB) and the TPROCESS block. 

The PCB defines the application program interface of a 
partition/region in the system using TCAM. Its purpose is to control 
communication and storage protection across partition/region boundaries. 
It also defines the user-written message handler (MH) responsible for 
processing messages to and from the application program. Since a PCB 
is required for each application program running with the MCP, a PCB 
is required to define the CICS application program. 

The TPROCESS control block controls communication to and from the 
application program. A separate block is required for both input and 
output to the application program. The application program is 
frequently referred to in TCAM as the Message Processing program (MPP) . 
A TPROCESS block is required for each input queue to CICS and for each 
output queue from CICS. In CICS there are corresponding Terminal 
Control Table line entries (TCTLE's) for each input queue and for each 
output queue (that is, for each TPROCESS block) . 

DD cards (such as those shown in Fiqure 11) are used to correlate 
the TCAM control blocks with the CICS control blocks. The CICS Terminal 
Control Table contains the DCB. The DDNAME specified in the Terminal 
Control Table macro instruction (DFHTCT TYPE=SDSCI,DDNAME=name) names 
the DD card. In the DD card, the QNAME field names the TCAM TPROCESS 
block. 

No exceptions are required for CICS to the TCAM Application Program 
Interface just described. For additional information, refer to the 
TCAM Programmer 's Guide and Referen ce Manual (GC30-2024) . 
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MCP (TCAM) 



MPP (CICS) 



APPLICATION 
MESSAGE HANDLER 




Figure 11. DD card correlation of TCAM and CICS control blocks 

CICS/TCAM INTERFACE 

A TCAM input process queue is considered to be a "line" to CICS. 
For each input process queue there is a CICS Terminal Control Table 
line entry (TCTLE) . Note that TCAM requires the application program 
(CICS) to have a DCB for each TPROCESS block; separate TPROCESS blocks 
are required for input to and output from the application. Therefore, 
each TCAM output process queue is also considered to be a line and has 
a corresponding CICS TCTLE. Each TCTLE references its own DCB generated 
by the DFHTCT TYPE=SDSCI macro instruction in CICS. 

The CICS Terminal Control Table terminal entries (TCTTE's) define 
the terminals associated with a particular line entry (TCTLE) . For 
each physical terminal communicating with CICS via TCAM, a corresponding 
TCTTE containing the terminal identification must be associated with 
a TCTLE. Duplicating individual TCTTE's for both the input TCTLE and 
the output TCTLE is avoided by attaching a single, special TCTTE to 
the input TCTLE and attaching all the individual TCTTE's to the output 
TCTLE. Although attached to the output TCTLE, they are used for both 
input and output processing. 

Each input record from TCAM must contain the source terminal 
identification (OPTCD=W specified in the CICS DFHTCT TYPE=SDSCI macro 
instruction) . Using this identification as a search argument, the 
corresponding TCTTE can be located by CICS. 

Using the POOL feature (POOL=YES of the DFHTCT TYPE=LINE macro 
instruction), it is possible to establish a pool of common TCTTE's on 
the output TCTLE that do not contain terminal identifiers. As required, 
terminal identifiers are assigned to the TCTTE's or removed from 
association with the TCTTE's. This POOL feature necessarily imposes 
a number of restrictions and should be thoroughly understood before 
being implemented. For additional information, see the discussion of 
the POOL operand. 
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Dat a Fo rmat 

When TCAM is specified, CICS assumes that the user transaction data 
passed to it from the TCAM queue is in the proper format to be passed 
directly to the user task. Except for the removal of the source 
terminal identification, CICS does not alter the data it receives. It 
is the user's responsibility (via his MCP) to properly prepare the 
data, such as translating to EBCDIC, stripping line control characters, 
and deblocking. The user may optionally bypass the CICS routine that 
removes the source terminal identification by returning from the 
user-written input exit (XTCMIN) in TCP with a displacement of zero 
bytes. 

Similarly, CICS assumes that the user transaction data passed to it 
for TCAM has been properly formatted for direct placement on the TCAM 
output process queue. Except for the insertion of the destination 
identification and the device-dependent control character, CICS does 
not alter the data it receives. It is the user's responsibility (via 
his MCP) to properly prepare the data for the destination terminal, 
such as translating and inserting line control characters. 

Logic Flow 

Below is a generalized description of the sequence of events that 
occurs in CICS when interfacing with TCAM. 

INPUT STEP AC TIO N 

A TCAM notifies CICS that it has data for a 

particular input TCTLE by posting its ECB. 

B CICS gets a TIOA and attaches it to the 

special input TCTTE in the TCTLE. 

C CICS issues a READ to TCAM which results in 

TCAM passing the data over the partition or 
region boundaries to the CICS TIOA. CICS 
indicates at this time that it has data to 
process. (See Figure 12.) 

D The input TCTLE points to the corresponding 

output TCTLE in response to the OUTQ 
specification of the DFHTCT TYPE=LINE 
macro instruction. 

E The individual TCTTE' s on the output TCTLE 

are searched for a matching source terminal 
identification. If POOL=YES has been 
specified, a free TCTTE is assigned to this 
, source terminal identification. 
(See Figure 13.) 

F If an input user exit (XTCMIN) has been 

specified, CICS links to the user exit routine 
where the user may edit his input data prior 
to passing it to his task. (See the dis- 
cussion of XTCMIN in the section "TCAM User 
Exits".) 

If no exit has been specified, CICS removes 
the eight-byte source terminal identification 
field inserted by TCAM. No other editing of 
the data is performed. 
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INPUT STEP 



ACTION 



TCAM INPUT 
PROCESS QUEUE 




A check is made to determine whether a task 
is attached to the individual TCTTE. If not, 
go to Step H. 

If a task is attached, a check is made to see 
if the task has issued a READ. If a READ 
request exists, go to Step J. If not, CICS 
halts the processing of data in the queue 
until the TCTTE becomes available or the 
attached task issues a READ. 

CICS attaches the appropriate task. A user 
exit is available prior to the actual attach. 
(See the discussion of XATTACH in the 
section "TCAM User Exits".) 

If the task could not be attached (e.g., a 
"maximum task" or "short on storage" 
condition exists) , CICS remembers it has data 
to process and exits DFHTCP. On the next 
scan, it again tries to attach the task. 

Once a task is attached, CICS stores the 
TCAM segment identifier in the TCTTE (if 
segment processing was specified by including 
the C parameter in the OPTCD operand of the 
DFHTCT TYPE=SDSCI macro instruction) . 

CICS passes control to the attached task. 



TIOA 



Figure 12. CICS issues a TCAM read 
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TCAF1 INPUT 
PROCESS QUEUE 




(ABC) 



TIOA 




Figure 13. After TCAM read CICS attaches TIOA to corresponding TCTTE 



O UTPU T STEP 
A 

B 



ACTION 

The user issues a WRITE request in his 
application program. 

The TCP terminal scan recognizes the WRITE 
request. 

CICS checks to determine if an output user exit 
(XTCMOUT) has been specified. If specified, 
CICS links to the user exit routine where the 
user may edit his output data prior to passing 
it to TCAM. (See the discussion of XTCMOUT 
in the section "TCAM User Exits".) 



CICS checks the four-byte 
TCTTEDES for a destinatio 
of DEST=NAME or DEST=YES 
in the DFHTC TYPE=WRITE m 
If present, CICS inserts 
byte destination field an 
field, padding blanks to 
CICS moves the source ter 
from the TCTTE to the des 



TCTTE field 
n saved as a result 
having been specified 
aero instruction, 
it in the eight- 
d left justifies the 
the right. Otherwise, 
minal identification 
tination field. 



CICS moves a one-byte communication control 
character into the ninth byte of the TCAM work 
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OUTPUT STEP ACTION 

area. See the section "Device Dependent 
Considerations". 

F CICS issues a TCAM WRITE to transfer the data 

to TCAM. 

G After checking for successful completion of 

the WRITE to TCAM, CICS posts the user task 
"dispatchable" if a task is still attached 
to the TCTTE. Otherwise, CICS frees the 
TCTTE for a new task. 

T ermi nal Error Pr ogr am 

The CICS/TCAM Interface implementation has resulted in the expansion 
of the CICS Terminal Error program (DFHTEP) error codes and conditions 
previously existing in CICS. The additional codes and conditions are 
described in the section "Creating a Terminal Error Program (DFHTEP) ". 

Me ssag e Routing 

The DEST operand of the DFHTC TYPE=WRITE macro instruction can be 
used to route an output message to a destination defined by the user 
in the TCAM MCP. This operand can be used to send a message to a 
destination other than the source terminal (such as to another terminal, 
a list of terminals, or another application) . 

If DEST=name is specified, "name" is stored in the four-byte field 
TCTTEDES. If DEST=YES is specified, it is the user's responsibility 
to have placed the destination name in TCTTEDES prior to issuing the 
WRITE macro instruction. 

CICS moves the data from TCTTEDES into the destination identification 
field prior to placing the data on the TCAM output process gueue. The 
user may bypass the CICS routine that inserts the destination field by 
taking the XTCMOUT user exit and returning to CICS from the exit with 
a displacement of zero. In this case the user must ensure that the 
TCAM header is properly formatted for output. 

If the DEST operand is omitted, CICS inserts the source terminal 
identification from the TCTTE into the destination identification field. 

S egment Process ing 

The CICS/TCAM Interface supports the TCAM segment processing 
capability. It permits segments of a message to be forwarded to CICS 
rather than waiting for the entire message to be received. If the user 
specifies segment processing (by including the parameter "C" in the 
OPTCD operand of the DFHTCT TYPE=SDSCI macro instruction) , CICS passes 
the segment to the user and places the one-byte position field control 
byte in the TCTTE field labeled TCTTETCM. Similarly on output, the 
user must supply the control byte in TCTTETCM for CICS to pass to TCAM. 
For additional information on segment processing, refer to the 
discussion of the OPTCD operand of the application input and output 
DCB in the OS/MFT and O S/MV T TCAM Programmer,' s Guide (GC30-2024) . 



143 



LLqg Pool Specification 

In generating the TCAM Message Control program the user defines each 
physical terminal to TCAM by means of a TCAM TERMINAL macro instruction. 
Since CICS also reguires terminal definitions, the user must prepare 
a Terminal Control Table terminal entry (TCTTE) for each terminal 
through use of the DFHTCT TYPE=TERMINAL macro instruction. As a result, 
a one-for-one correlation exists between terminal definitions in TCAM 
and in CICS. 

In a highly restricted environment, this duplication of terminal 
definitions can be reduced through use of the POOL feature (DFHTCT 
TYPE=LlNE,POOL=YES) . Instead of a one-for-one relationship, a "pool" 
of generalized TCTTE* s is defined for a TCAM process gueue (line). 
When a transaction is received over the TCAM "line", a search is made 
for an available TCTTE in the pool. When one is found, it is assigned 
the source terminal identification for the duration of the task. Upon 
completion of the task, the TCTTE is available for reassignment. If 
there are no available TCTTE's to handle the next transaction from the 
line, the line remains locked until a TCTTE becomes available through 
task completion. The number of TCTTE 1 s in the pool influences the 
degree of multitasking. 

Because the TCTTE 1 s are not permanently assigned, the use of the 
POOL feature is possible only in a restricted environment. The POOL 
feature is applicable only for those applications in which each record 
received over the input process gueue is a new transaction. Thus, the 
user should thoroughly analyze his environment before specifying the 
POOL=YES option in the DFHTCT TYPE=LINE macro instruction. 

Line Poo l Restrictio ns 

The following are line pool restrictions of which the user must be 
aware: 

1. Only one terminal type is permitted per TCAM line (process gueue) 
because of certain device dependencies within CICS. 

2. Tasks attached from transactions over the TCAM line are not 
permitted to issue Terminal Control READ reguests. This includes 
GET, PAGE, and CONVERSE because they contain implied READ'S. 
Violation of this restriction can cause a permanent line lock 

on the input process queue, thereby preventing any further 
transactions on the gueue from reaching CICS. 

3. Segment processing reguires multiple READ'S which can cause a 
permanent line lock. Therefore, segment processing (OPTCD=WDC) 
must not be specified. 

4. Automatic task initiation is not applicable in the pool 
environment. 

5. Statistics are accumulated for each TCTTE in the pool; however, 
the statistics cannot be correlated to the physical terminals. 

6. Only one sign on can exist for all terminal entries in a given 
line pool at any one time. The first sign on received by CICS 
is propagated to all terminals in the pool. Any subsequent sign 
on is rejected. A sign off clears the sign-on data from all 
terminal entries in the pool; a subsequent sign on is then 
accepted. 

7. Master terminal functions require multiple READ'S and cannot, 
therefore, be used on terminals with pooled TCTTE 's. 
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.Line Locking 

Line locking of two types can occur: (1) a temporary lock that 
resolves itself in time, and (2) a permanent lock that remains permanent 
unless the user takes action in his Terminal Error program. Adherence 
to the pool restrictions outlined in the previous topic should eliminate 
the permanent lock situation. 

A temporary line lock occurs when no TCTTE's are available in the 
pool and a new transaction appears on the input queue. CICS locks the 
queue until an existing task completes execution, thus freeing a TCTTE. 
In this case, the completion of existing tasks is not dependent upon 
additional input from the queue. 

A permanent line lock can occur when multiple reads are required to 
complete a task. For example, assume that there are two TCTTE's in 
the pool, that a task is attached to each, and that the segments in 
the input queue are in the following order: 

1. Segment #1 for a third transaction 

2. Subsequent seqments for the two active tasks 

Since no TCTTE is available in the pool for the third transaction, 
it must wait for a task to complete for a TCTTE to become available. 
Because the TCAM input queue is processed sequentially, tasks 1 and 2 
are unable to receive their subsequent segments. Hence, they cannot 
complete, and the queue remains permanently locked (because line pool 
restriction 2 of the previous topic was not observed) . 

Queue Considerations 

Since a queue is a sequential data set, the second record on the 
queue cannot be retrieved until the first record has been processed. 
To keep records flowing smoothly through the queue, it is essential 
that each record be processed as soon as it arrives. In the CICS/TCAM 
Interface, "processing the record" means detaching the TIOA (containing 
the record) from the special input TCTTE and attaching it to the 
individual TCTTE correlated to the actual physical terminal. Each 
individual TCTTE may be considered to be a "destination" for the purpose 
of this discussion. 

If a particular destination (TCTTE) is not ready to accept the 
current record on the queue, the queue necessarily "locks" until the 
destination can accept the record. Queue locks are only a problem when 
a queue is serving more than one destination. Then, if a queue locks, 
any new transaction on the queue or data records queued for existing 
tasks are not processed until the required destination has accepted 
the current record. 

Since queue locks can adversely affect system performance, it is 
important that the user understand their cause and effect. Proper 
configuration of TCAM process queues and CICS Terminal Control Tables, 
reduces to a minimum the occurrences and duration of queue locks. 

Because TCAM can read ahead from the terminals, it is possible for 
TCAM to present to CICS a new transaction record destined for a TCTTE 
that is already processing a task. Also, TCAM can present a data record 
for an existing task prior to that task issuing a READ request. In 
either case, CICS cannot "process" the record (as described above) 
until the TCTTE is ready to accept the new TIOA. Such input is called 
"unsolicited input". 

Three conditions can produce unsolicited input: (1) the CICS terminal 
for which the data is destined is OUT OF SERVICE, (2) the CICS terminal 
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for which the data is destined is in RECEIVE status, or (3) the CICS 
terminal for which the data is destined has an associated task that 
has not issued a READ and the period of time indicated by the NPDELAY 
specification has expired. In all cases, the action taken by the 
CICS/TCAM Interface is to place the input line OUT OF SERVICE and attach 
DFHTACP to process the error condition. 

The default action taken by DFHTACP (which can be altered by 
user-written DFHTEP) for conditions 1 and 2 is to discard the data and 
place the input line IN SERVICE. No default action is taken by DFHTACP 
for condition 3; therefore, the input line remains OUT OF SERVICE, 
thereby preventing CICS from reading any subseguent records from the 
input gueue. 

To allow processing of input to continue, DFHTEP must take 
appropriate action. If the input line is placed IN SERVICE by DFHTEP, 
the CICS/TCAM Interface retries the operation; in this case, a count 
mechanism is recommended in DFHTEP to prevent a loop in the event the 
task never issues a READ. Alternative action, perhaps when a count 
limit is reached, might be to abend the task, dispose of the data, and 
place the line IN SERVICE. For further information concerning DFHTEP, 
see the section "Creating a Terminal Error Program". 

The problem of unsolicited input can be eliminated entirely by having 
a separate TCAM input process gueue for each CICS terminal (TCTTE) . 
However, as the number of terminals increases, this solution may quickly 
become prohibitive in terms of main storage requirements. 

The user should analyze the type of traffic he anticipates over the 
gueues. If he uses a 2770 Data Communication System or 2780 Data 
Transmission Terminal to read in volumes of cards, he should consider 
separate gueues for these devices. The Asynchronous Transaction 
Processing (ATP) function in CICS should be seriously considered for 
processing batches of data to minimize the time between task READ 
reguests. For conversational traffic with short-lived tasks, the 
sharing of queues is certainly feasible. The same TCAM output process 
gueue can be specified for multiple input process queues. (See the 
discussion of the DFHTCT TYPE=LINE,OUTQ=symbolic name specification in 
the section "System Table Preparation".) 

The user need not be concerned with locking of the TCAM output 
process queue since TCAM requeues the data by final destination once 
it arrives over the output queue. 

It is possible for the TCAM output process queue to become congested 
due to lack of queuing space. In this case, CICS has a WRITE to the 
queue outstanding until TCAM accepts the data. 

TCAM DEVICE CONSIDERATIONS 

In the non-TCAM environment, the CICS Terminal Control program is 
responsible for polling and addressing terminals, code translation, 
transaction initiation, task and line synchronization, and the line 
control necessary to read from or write to a terminal. When TCAM is 
specified. Terminal Control relinguishes responsibility to the TCAM 
MCP for polling and addressing terminals, code translation, and line 
control. To take advantage of TCAM facilities, the user must accept 
the responsibility of coding in the MCP Message Handler functions such 
as code translation previously handled by the CICS Terminal Control 
program. 

For some terminal services, it is necessary for CICS to pass the 
user reguest on to the TCAM MCP Message Handler. A communication 
control byte in the TCAM work area has been established for this 
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purpose. It is passed to TCAH along with the eight-byte destination 
name field. Based on the communication byte, the user must execute 
the proper MCP Message Handler macro instructions to accomplish the 
necessary function. 

The terminal services parameters that do not set bits in the 
communications byte are WRITE, READ, WAIT, and SAVE. Bits in the 
communications byte are set for the 2260 parameters WRITEL and READL, 
the 2760 parameter OIU, and the DISCONNECT parameter. 

The CICS/TCAM Interface does not support the RESET parameter or the 
3270 parameters READB and COPY. 

All messages to TCAM from CICS are prefixed with the standard 
CICS/TCAM communication byte. This byte is used to convey to TCAM 
request functions that cannot be issued within CICS (such as WRITEL to 
a 2260). Request functions maintained are DISCONNECT (X'08')r READL 
(X'10')/ and WRITEL (X«20')« 

TCAM/2260 Dev ice Considerations 

The following CICS screen control macro instructions are passed to 
the TCAM Message Control program (MCP) : 

1. DFHTC TYPE=WRITE,LINEADR=number 

2. DFHTC TYPE=WRITE,LINEADR=YES 

3. DFHTC TYPE= (WRITE, ERASE) 

These macro instructions are passed in the following format: 



8 Bytes 



I 



Destination 



Start of message 

Line addressing character (if 
specified) 

Screen control (1 byte) : 
X»A0", Set WRITE direct 
X'BO', LINEADR request 
X'EO', ERASE request 

Standard communication byte that 
heads all messaqes to TCAM 



For a 2848 Control Unit Model 21 or 22, the communication byte is 
used to transmit READL and WRITEL requests to be executed by the TCAM 
MCP. 
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TCAM/3270 Devic e Considerations 

Messages passed to CTCS from TCAM are of the following format: 



8 Bytes 



I 



Destination 



Message 

Cursor (2 bytes) 
•Aid (1 byte) 



Messages passed from CICS to TCAM are of the following format: 



8 Bytes 



l 



Destination 



T 



Message 



-WCC (Write Control Character) 

- Command 

- Escape character 



Standard CICS-to-TCAM 
communication byte 



All SOH% status messages input to CICS are passed to DFHTACP/DFHTEP. 

DFHTC TYPE=COPY and DFHTC TYPE=READB are not supported by the 
CICS/TCAM Interface. 

In addition to normal read/write functions, the ERASEAUP, CTLCHAR, 
UCTRAN, and COMPAT operands are also valid for the 3270. 

TCAM USER EXITS 

The three user exits applicable to the TCAM user are XATTACH, XTCMIN, 
and XTCMOUT. Whereas XATTACH is shared by other users, XTCMIN and 
XTCMOUT are applicable only to TCAM users and are used in place of the 
XINPUT and XOUTPUT exits used by others. See the section "Creating 
User Exits for CICS Management Programs" for further information 
concerning CICS user exits. 

Task Attach User Exit (XATTACH) 

This operand is used to generate linkage in the Terminal Control 
program TCAM module in TCP to a user-written exit routine. The linkage 
is generated at the point prior to issuing a Task Control ATTACH for 
a transaction identification received in response to polling. In the 
CICS/TCAM Interface this information is received over the TCAM input 
process queue. 
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Input User Exit (XTCHIN) 

This operand is used to generate linkage in the Terminal Control 
program TCAH module to a user-written exit routine. The linkage is 
generated at the point following the completion of any input event. 
If specified, the linkage is executed after the individual TCTTE is 
located, just before CICS checks to see if a task is attached to the 
TCTTE. At this time the TIOA contains the 12-byte storage accounting 
field and the work area from TCAH. The work area contains an eight-byte 
source terminal identfication header and the work unit (user data) . 
TIOADBA points to the user data area. 

The user has two options in returning from the user exit. If the 
user returns with a displacement of four bytes (an Assembler B 4(14) 
instruction) , CICS removes the eight-byte source terminal identification 
field. Upon completion, the TIOA contains the 12-byte CICS storage 
accounting field and the work unit. (See Figure 14.) 

If the user returns from the exit with a zero displacement (an 
Assembler B 0(14) instruction), CICS does not alter the data in the 
TIOA. It is then the user's responsibility to handle the TCAH header. 

For a discussion of TCAM work areas and work units, refer to the 
section "Defining the Application Program Work Area" in the OS^MFT and 
OS/HVT TCAH Programmer's Guide (GC 30-2024) . 

Qut£Ut User Exit (XTCMOUT) 

This operand is used to generate linkage in the Terminal Control 
program TCAH module to a user-written exit routine. The linkage is 
generated for output events at the point prior to placing data on the 
TCAH output process gueue. 

The user has two options in returning from the exit. If the user 
returns from the exit with an Assembler B 4(14) instruction, CICS 
inserts in the TIOA, between the 12-byte CICS storage accounting field 
and the work unit, a TCAH header consisting of an eight-byte destination 
field and a one-byte communication control character reguired for TCAH. 
If the user returns from the exit with an Assembler B 0(14) instruction, 
CICS bypasses this insertion routine. It is then the user's 
responsibility to ensure that the TCAH header is properly formatted. 

Figure 14 shows the composition of the TCAH Work Area and the CICS 
Terminal Input/Output Area (TIOA) at the various stages of operation. 
On input, it shows the information available from the TCAH input process 
queue, the TIOA after input event completion, and the TIOA as it is 
passed to the user task after CICS has edited out the origin field. 
On output, it shows the TIOA (after CICS has edited in the destination 
field) in the format in which it is placed on the TCAH output process 
queue. 

The TCAH origin field contains the source terminal identification 
field. Since CICS uses four-byte Terminal ID's, the name is 
left- justified and the field is padded to the right with four blanks. 

Note: The TCAH destination field contains the destination 
identification for TCAH to properly route the data. 

If the user specifies the output user exit and returns from the exit 
with a zero displacement, CICS does not alter the TIOA work area. The 
user must provide the data length at TIOATDL and must prepare the work 
area for TCAH, including the eight-byte destination field and the 
communication control byte. 



149 



TCAM WORK AREA from 



(?- 8 Bytes — ^ 

Origin ^r-r — ^ User 
-• id UMeJJ Transaction Data 



the input process queue .. Jn r _. \ , 

K y M Start .of Start of 



I Origir 

I Fiel( 

AT * 



End\of 



Work \ Area Work Unit Work \ Area 



TIOA after Input Storaae 

Event Completion; | Accounting 



\ \ 

\ 

|S- 1 2 Bytes -4fr 8 Bytes i 

Origin 



CN^ti~2) f x \ / 

tioa\ \ / 

N X / 



Field User Transaction Data 



TIOA after CICS editing \*— 12 Bytes ^ ' 

\ Storage \ •' 

I Accounting | 

A /^ 



User Transaction Data 



/ T „« / \ 



/ HUM / ^ 



TIOA / 

/ / \ \ 

TIOA before output Event / 19 D „ tQC / \ \ 

Completion after CICS f — l * Bytes.^ 8 Bytes _^ 
insertion routine: i Storage . Destination . \ 

I Accounting | Field | | User Transaction Data 
(NOTE 4) 



t * (Note 3) t 



TIOA Start of Communication 

Work Area Control Byte End of 

Work Area 



The Work Area is placed on 
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Figure 14. Stages of the TCAM work area and CICS terminal input/output 
area (TIOA) 

CICS/TCAM STARTUP 

The TCAM MCP must be in operation prior to completing CICS system 
initialization. When the user brings up CICS with the CICS/TCAM 
Interface, CICS checks for the presence of a TCAM partition/region and 
issues the operator message: 

DFH1500 - CICS CHECKING FOR TCAM MCP 

If CICS discovers the MCP is not operational, the following messages 
are issued: 

DFH1520 - TCAM MCP IS NOT CURRENTLY AVAILABLE 
DFH1520 - REPLY RETRY OR CANCEL OR CONTINUE 

The operator must then respond: 

RETRY 
when the TCAM partition/region becomes active; or 

CANCEL 
to terminate CICS; or 

CONTINUE 

to continue initialization of CICS in the absence of the TCAM partition/ 
region. 
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If the operator responds CONTINUE, all DD cards that reference a 
TCAM queue must have been previously removed from the startup deck to 
avoid an abnormal termination of CICS. The CONTINUE response is 
applicable to a mixed BTAM/TCAM mode of operation when TCAM lines are 
not being used during execution of CICS. 

CICS/TCAM ABEND/RESTART 

If the TCAM Message Control program (MCP) terminates abnormally, 
any TCAM application programs currently active are automatically 
terminated abnormally, providing there is at least one open line group 
in the MCP. The CICS application program is no exception. For further 
information, see the discussion concerning "Coordinating MCP and 
Application Program Restarts" in the OS/MFT and OS/MVT TCAM Programmerls 
Guide (GC30-2024) . CICS does not provide RESTART capability. 

CICS/TCAM TERMINATION 

CICS is terminated in the normal manner. No modifications to 
termination procedures are required to support the CICS/TCAM Interface. 
If both CICS and TCAM are being terminated, CICS ahould be terminated 
first to avoid an abnormal termination of CICS. 
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SYSTEM ADMINISTRATION 



REAL-TIME S YSTE M ADMINISTRATION 

Administration of a real-time data base/data communications (DB/DC) 
system involves considerations not ordinarily applicable to the 
traditional batch processing environment. These real-time DB/DC 
considerations include: 

1. Multiple application environment, often involving common or 
related data bases 

2. Managing data centrally on behalf of all applications 

3. Transactions arriving on a random nonscheduled basis for 
asynchronous (concurrent) processing upon arrival 

4. Transaction processing sometimes of long duration (for example, 
continuous 24-hour operation) 

5. Communication across multiple time zones (sometimes involving 
foreign as well as domestic interstate communication) 

6. Interface with multiple vendors of data processing services and 
eguipment 

It is the responsibility of the system administrator to deal 
creatively with these new dimensions and complexities in data 
processing, seeing to it that the system is "tuned" for optimum 
performance and service. 

SYSTEM CONTROL FUNCTIONS 

The dynamics of the data base/data communication (DB/DC) environment 
make it necessary to be able to change system control parameters. 
Certain of the parameters are changeable, if allowed by the system 
administrator or by the supervisor and terminal operators. Those 
facilities and the considerations for invoking them are described in 
the Term ina l Operator's Gui de (SH20-1044) . The primary system control 
is provided through the master terminal. 

The master terminal function is a logical rather than a physical 
consideration. This function can be invoked from any terminal that 
the system administrator allows, but is intended for use by a master 
terminal operator. In addition to the administrative terminal 
facilities described in the Terminal Oper ato r's Guide, the master 
terminal may alter other system parameters that control the performance 
of the system. These control parameters are to be changed in the 
day-to-day operation of the system to effect the desired performance. 
They can also be changed in the process of tuning the system to obtain 
optimum performance under differing conditions. 

The terminal administration facilities are described in the Terminal 
Operator's Guide. The system administration functions intended for 
exclusive use from a master terminal are described below. 



MASTER TERMINAL 

The Master Terminal program is a conversational program that leads 
the user through each transaction if sufficient information to perform 
the requested service was not entered in the original data entry. 

The services provided by the Master Terminal program allow the master 
terminal operator to: 
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1. Inquire about or change the partition exit time interval value. 

2. Inquire about or change the runaway task interval value. 

3. Inquire about or change the stall detection interval value. 

4. Inquire about or change the storage cushion size. 

5. Inquire about or change the maximum number of tasks value. 

6. Inquire about or change the maximum number of batch tasks value. 

7. Inquire about or change the maximum number of ATP tasks value. 

8. Inquire about or change the negative poll delay for a terminal. 

9. Inquire about or change the trigger level or a transient data 
intrapartition data set. 

10. Turn the CICS Trace function on or off. 

11. Inquire about or change the status of a single terminal. 

12. Change the status of a list of terminals. 

13. Change the status of a class of terminals. 

14. Change the status of all the terminals in the system. 

15. Inquire about or change the status of a line. 

16. Inquire about or change the status of a control unit. 

17. Inquire about or change the status of one or more data base 
data sets. 

18. Open one or more data base data sets. 

19. Open one or more transient data extrapartition data sets. 

20. Open the dump data set. 

21. Close one or more data base data sets. 

22. Close one or more transient data extrapartition data sets. 

23. Close the dump data set. 

24. Switch the dump data set to the alternate dump data set. 

25. Inquire about the status of a proqram. 

26. Terminate a task. 

27. Terminate CICS. 

System Pa rt ition/ Re gion Exit Time Interval 

The partition/region exit time interval is the maximum interval of 
time that CICS will release control to the operating system in the 
event there are no transactions ready to resume processing. This binary 
time interval can be any three-to-ten-digit decimal value in the range 
from 100 to 27962020 milliseconds. A typical range of operation might 
be 100 to 2000 milliseconds. 

Runaway Task Time Interval 

Any task given control through the Task Control program returns 
control to Task Control within a user-defined interval of time. Tasks 
not meeting this time requirement are considered to be in a runaway 
(logical loop) state and are deleted from the system. This binary time 
interval can be any three-to-ten-digit decimal value that is not less 
than the partition/region exit time interval and not greater than 
27962020 milliseconds. A typical runaway task time interval might be 
5000 milliseconds. If the runaway task time interval is set to zero, 
the feature is made inoperative. 

Stall Time Inter val 

If CICS remains in an overload condition for the duration of the 
stall time interval, it is assumed that a system stall exists and 
corrective action is initiated. This binary time interval can be any 
three-to-five-digit decimal value that is not less than the 
partition/region exit time interval and not greater than 32767 
milliseconds. A typical stall time interval might be 20000 
milliseconds. 
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Storage Cus hio n Siz e 

The system storage cushion is used by CICS to minimize system 
overload conditions. The cushion size does not actually change until 
the existing cushion is released. When the cushion is then regained, 
the cushion is of the size indicated by the new value. If a cushion 
size change is requested and the existing cushion is not released, the 
cushion size remains unchanged. The cushion size can be any 
two-to-five-digit decimal value (representing number of bytes) in the 
range from 20 to 65535. 

Negative Poll Delay 

The negative poll delay function allows the user of CICS to delay 
the polling of BTAM devices on a line when negative responses are 
detected. This facility allows some control over the CPU overhead 
required to service negative poll interrupts. The request must be made 
in milliseconds and has a range from to 20000. Once a terminal on 
that line enters into a conversational-mode transaction, that terminal 
receives a full poll until the transaction is completed. 

Maximum Number of Tasks 

CICS limits the number of tasks that can be in the system at any 

one time to the number indicated by this user-defined value. This 

value can be changed dynamically in the range from 1 to 999. In the 

CICS/DOS-ENTRY system, the maximum number of tasks cannot be changed 
dynamically since the Rollout facility is initialized at a specified 

number during system initialization and cannot change unless CICS is 
reinitialized. 

Co nsecu tive Dispatch Limit 

The consecutive dispatch limit is valid only in the CICS/DOS-ENTRY 
system. When a transaction has performed the number of input/output 
operations (other than terminal input/output) specified by the 
consecutive dispatch limit, a task switch is initiated by CICS. The 
consecutive dispatch limit can be any value between 1 and 999. 

Trigger Level 

If a Transient Data intrapartition data set is marked for automatic 
task initiation, CICS automatically initiates the task when the 
specified number of requests for output operations (indicated by the 
trigger level for that destination) have been issued for that 
destination. The trigger level can be any value between and 32767. 

Trace 

If the CICS trace function is not generated as part of the CICS 

nucleus, the trace function cannot be turned on. If the CICS trace 

function is generated as part of the CICS nucleus, turning it off does 

not remove it from the system; the trace function is still in main 
storage, but is not executed. 

Iliiiil Base Data Sets 

The status of data base data sets reflects one or more of the 
following: 
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1. Read 

2. Update 

3. Add 

4. Exclusive Control 



Dump Data Set 



Optionally, the user can define two dump data sets (DFHDMPA and 
DFHDMPB) , alternating between them during real-time execution of CICS. 
If there are two dump data sets, a 'switch* reguest closes the dump 
data set that is currently open and opens the other dump data set. 
This allows the user to print the CICS formatted dumps on the first 
dump data set without having to terminate CICS. 

P^P-SX^m S tatu s 

The status of a program is comprised of the following: 

1. The language in which the program was written 

2. The size of the program in bytes 

3. Whether or not the program is permanently resident in main storage 

4. Whether or not the program is currently in main storage 

5. The number of times the program has been used 

6. The number of transactions that are currently using the program 

D yna mic Open/ Clo se 

The optional CICS dynamic open/close facility allows the user to 
dynamically open/close his data sets as often as desired during the 
real-time execution of CICS. For example, this makes it possible for 
the user to defer the opening of data sets at System Initialization 
and open/close them later through the master terminal as they are 
needed. The dynamic open/close capability is applicable to File 
Management (data base data sets) , Dump Management (dump data sets) , 
and Transient Data Management (extrapartition data sets) . Those 
CICS/DOS extrapartition sequential disk data sets that are to be closed 
and re-opened by the dynamic OPEN/CLOSE function of the Master Terminal 
Program must be defined as nonresident or records may be lost. 

Terminate a Task 

The only time a task is not terminated upon request is when the 
requested task is currently reading from or writing to a terminal. 

System Ter mina tion 

CICS can be terminated from the master terminal by entering the 
transaction identification: 

CSMT 
The system responds: 

WHAT SERVICE IS REQUESTED? 
The master terminal operator should enter: 

SHUTDOWN 
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The system will respond: 

IS SHUTDOWN TO BE IMMEDIATE? 

The operator can respond with one of the following: 

NO 

NO, DUMP 

YES 

YES, DUMP 

If the system is to be terminated without regard to the existence 
of any active transactions (tasks), the operator should enter 'YES 1 . 
If the operator wishes to wait until there are no active transactions 
in the system, he should respond 'NO'. 

Note: If the user of the CICS/DOS-STANDARD system requests immediate 
termination of CICS while active transactions are communicating 
with terminals, unpredictable results could occur; that is, 
active terminals could receive input/output data from other 
active terminals within CICS. 

If the master terminal operator wishes to receive a main storage 
dump upon completion of the termination process, he should respond 
either 'YES, DUMP' or 'NO, DUMP'. 

If immediate termination is not requested, if Asynchronous 
Transaction Processing (ATP) is being used, and if there are batches 
currently in a HOLD status, the operator must respond: 

CATP STOP 

to complete the quiescing process. 

When termination is initiated, the following message is displayed 
on the system console and on the master terminal: 

DFH1701 - CICS IS BEING TERMINATED 

When termination is complete, the following message is displayed on 
the system console: 

DFH1702 - NORMAL TERMINATION COMPLETE 

If a dump is requested, the following message is displayed on the 
system console when termination is complete: 

DFH1791 - ABNORMAL TERMINATION COMPLETE 



DATE AND TIME OF DAY CONTROL 

In the course of normal operation, CICS maintains the current date 
and time of day within the Common System Area (CSA) . The current 
(Julian) date of the form YYDDD is maintained in packed decimal 
representation at CSAJYDP, where YY is years and DDD is days. The 
current time of day is maintained in three formats: (1) in packed 
decimal at CSATODP of the form HHMMSSS, where HH is hours, MM is 
minutes, and SSS is seconds to tenths of a second, (2) in binary decimal 
at CSACTODB to hundredths of a second, and (3) in binary decimal timer 
units at CSATADJT to 300ths of a second. The current date is initially 
set by the CICS System Initialization program to agree with the date 
maintained by the operating system. The time of day values are updated 
during task dispatching to reflect the time of day maintained by the 
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operating system. The accuracy of these values depends upon the task 
mix and frequency of task switching occurrences. 

Since the time of day maintained by the operating system can be 
changed either by the operating system (for example, OS resetting the 
clock to zero at midnight) or by the console operator, CICS must 
recognize the situation where a "negative" change in the time of day 
has occurred, and must adjust expiration times maintained by CICS 
accordingly. 

If the optional time adjustment feature of CICS Time Management is 
not included in CICS, any change to the operating system time of day 
involving midnight is represented by CICS as a value larger than the 
previous value (for example, 1:00 a.m. is represented as 2500 hours) ; 
the date remains unchanged. If the optional time adjustment feature 
is included in CICS (by including the ICPTIME=YES operand in the DFHSG 
PROGRAM=ICP specification) , and if either the time-ordered task 
synchronization feature or automatic task initiation feature of CICS 
Time Management is also included, any change to the operating system 
time of day is automatically reflected in the expiration times 
maintained by CICS; the date maintained by CICS is reset to agree with 
the data maintained by the operating system. 

In the case of CICS/OS, when the operating system time of day is 
set to zero at midnight (and the time adjustment feature has been 
included in CICS), CICS/OS adjusts the expiration times of day it 
maintains, changes the date, and then resets its time of day to zer< 
In the case of both CICS/OS and CICS/DOS, when the operating system 
time of day is changed by the console operator to a value less than 
the previous value, CICS adjusts the expiration times it maintains to 
reflect the negative value and then resets its date and time of day to 
those values maintained by the operating system. The optional time 
adjustment feature thus makes it possible for CICS to be operated on 
a continuous round-the-clock basis. 

The optional time adjustment feature is included in CICS by 
generating the Time Adjustment program (DFHTAJP) as part of the Control 
System Operational group (CSO) . The user must provide a corresponding 
entry in the Processing Program Table (PPT) and the appropriate 
Transaction Identification (CSTA) as an entry in the Program Control 
Table (PCT) referencing DFHTAJP. 

When a negative change in the time of day maintained by the operating 
system is detected by CICS, transaction CSTA is automatically initiated. 
A message is then sent to the console operator informing him that the 
CICS time of day has been changed to reflect the change in the time of 
day maintained by the operating system. 

CICS does not recognize a change to just the date field. However, 
if transaction CSTA is initialized after the date maintained by the 
operating system has been changed, the date maintained by CICS is 
updated accordingly. 

SYSTEM STATISTICS 

Statistics maintained by the various CICS management programs can 
be displayed during the day in part or in their entirety on the request 
of any terminal operator whose security code allows the request of such 
information. 

Statistics are transmitted to the Transient Data destination CSSL 
as variable-length, unblocked records (maximum block size equal to 136) 
when the system is normally terminated or when requested by the terminal 
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operator. When requested by a terminal operator, an alternate 
destination may be specified. 

To request all system statistics, the followinq transaction is 
entered by the terminal operator: 

CSTT AOR destid 

To request selected statistics, the following transaction is entered 
by the terminal operator: 

CSTT SOR destid label, label, label, DONE 

The 'destid' is used to specify the four-character destination 
identification to which statistics are to be sent. If this field is 
blank (consisting of six blank characters between "SOR" and "label") , 
CSSL is the default destination. 

The 'label 1 corresponds to any of the following labels which request 
a particular set of statistics. 

LABEL SET OF STATISTICS 

TERM Terminal statistics 

PROG Program statistics 

FILE File statistics 

TASK Task statistics 

STOR Storage statistics 

DUMP Dump statistics 

TRAN Transient data statistics 

TEMP Temporary storage statistics 

DYNAMIC OPEN/CLOSE FUNCTION 

The optional CICS Dynamic Open/Close facility allows the user to 
dynamically open/close his data sets as often as desired during the 
real-time execution of CICS. This makes it possible for the user to 
defer the opening of data sets during system initialization and 
open/close them later as they are needed. The dynamic open/close 
capability is applicable to File Management (data base data sets) , Dump 
Management (dump data sets) , and Transient Data Management 
(extrapartition data sets) and may be invoked via the Master Terminal 
program or through the use of the DFHOC macro instruction in an 
Assembler language application program. 

For a discussion of open/close via the Master Terminal program, see 
the section "Master Terminal" in this publication. 

The Open/Close macro instruction (DFHOC) is used to request any of 
the following services: 

1. Open, close, or switch dump data sets. 

2. Open or close data base data sets. 

3. Open or close transient data extrapartition data sets. 

Note: The DFHOC macro instruction is intended for use by the system 
programmer as a means of system control; it should not be used 
by the application programmer to open/close his data sets , as 
improper use of this macro instruction can cause serious 
degradation of system performance. 

The following operands can be included in the DFHOC macro 
instruction: 
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DFHOC TYPE=OPEN, * 

D AT ASET=TRANSD ATA, DATABASE, DUMP, * 

LISTABR= (register) , (symbolic register) , YES, * 

SYMEADR=symbclic address, * 

DSETID= (name, (xx) , ), * 

CHECK=symbolic address 

DEHOC TYPE=CLOSE, * 

EATASET=TRANSDATA,DATAEASE,DUMP, * 

IISTADR= (register) , (symbolic register) , YES, * 

SYMEADE=syrabclic address, * 
DSETID= (name, . . .) , 
CHECK=symtclic address 



* 



EEHOC TYPE=SWITCH, * 

EATASET=DUMP 

OPEN DATA SETS (OPEN) 

The programmer can open a data set or series of data sets by issuing 
the 

DEHOC TYPE=OPEN, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMEADR=symbclic address, * 

DSETID= (name, (xx) , ), * 

CHECK=symbolic address 

macro instruction. He must provide the parameters needed by specifying 
them in the macro instruction or, in the case of LISTADR, by placing 
the address of the parameter list (built by the user) in the TCA at 
TCAOCLA and specifying LISTADR=YES. 

Note: Parameters and/or parameter lists built in conjunction with this 
macro instruction should be built in the TWA or in storage 
acguired by the CICS Storage Control macro instruction as data 
in a program area could be lost. 

A discussion cf the operands that can be included in the DFHOC 
TYEE=OPEN macro instruction follows. 

DATASET: Specifies whether the reguest is for a transient data 
extrapartition data set (TRANSDATA) , a data base data set (DATABASE) , 
or a dump data set (DUMP) . 

LISTADR: Not applicable if DATASET=DUMP is specified. Specifies the 
register or symbolic register name containing .the address of the 
open/close parameter list built by the user. If LISTADE=YES is 
specified, this address can be placed in the TCA at TCAOCIA. If the 
LISTADR operand and SYMBADE operand are omitted, execution of the DFHOC 
macro instruction causes the list to be built for the user starting 
with the first byte of the TWA. In this case, it is the user's 
responsibility to make sure that the required space is available in 
the TWA. The space can be calculated using the formula: 

Space = (n x 12) + i\ 

where "n" is the decimal number of twelve-byte entries in the open/close 
parameter list and the "4" represents four bytes of hexadecimal F»s to 
signify the end of the parameter list. 
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The symbolic storage definition (DFHOCLDS) of a parameter list entry 
is provided by CICS. The format cf a twelve-byte entry in the 
open/close parameter list is: 

^JJNSDATA 

WOBD 1: Four-byte Destination ID. 

WOBD 2: Four bytes of the form bbxx where bb is two bytes of 
blanks and xx is a two-byte suffix of the data set 
control block created by the DCT assembly. The contents 
of this field are ignored when using resident control 
blocks. 

WOBD 3: Error byte plus three-byte address of DCT entry (this 
information is supplied by CICS) . 

DAIABASE 

WCBDS 1 and 2: 

Data set name (left justified, padded with blanks) . 
WOBD 3: Error byte plus three-byte address of FCT entry (after 

completion) . 

In CICS/OS, the user can optionally specify, in WOBD 2 of a TBANSDATA 
entry, the parameter list address pointing to a storage area. This 
storage area contains information to be placed into a dummy DCB before 
opening it. If an address is placed in this field, the first byte must 
be set to a hexadecimal FF. The symbolic storage definition (DFHOCODS) 
of this parameter list is provided by CICS. The format of the parameter 
list is as fellows: 



Byte 1 
Byte 2 
Byte 3 
Byte 4 



Open Options byte 
BUFNO byte 
BECFM byte 
EBBOPT byte 



Eytes 5,6: LBECL 
Bytes 7,8: BLKSIZE 
Bytes 9-16: DENAME 

The first eight bytes must contain the correct hexadecimal codes for 
the desired parameters, since the 16 bytes of the open/close parameter 
list are moved into the CCB. 

SYMEAEB: Not applicable if EATASET=DUMP is specified, this operand 
indicates the synbelic address of an open/close parameter list built 
by the user. If the SYMEADB and LISTADB operands are omitted, execution 
of the DFHOC macro instruction causes the parameter list to be built 
for the user starting with the first byte of the TWA. For a discussion 
of the parameter list, see the discussion of the LISTADB operand in 
this section. 

DSETID: Not applicable if EATASET=DUMP is coded or if the LISTADB or 
SYMBADB operand is used, this operand specifies the data set names or 
destination identifications to be used in constructing a parameter 
list. If a suffix is specified, it must be separated from the name or 
destination identification by a comma and must be enclosed in 
parenthesis. 

If DATASET-DATABASE is coded, up to 255 data set names can be 
specified with a single use of the DSETID operand. If DATASET=TBANSDATA 
is coded, up to 255 destination identifications can be specifed with 
a single use of the DSETID operand. If TYPE=OPEN is coded and if the 
destinations are nonresident, "xx", a two-character suffix of the data 
set control block (DCB for CICS/OS, DTF for CICS/DOS) must be provided 
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with each destination identification; if the destination is resident, 
the "xx" suffix is ignored. 

In CICS/OS, if "xx" consists of more than two characters, it is 

assumed to be the symbolic address of a list of options and parameters, 
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to be moved into the DCB. For the format of this list, see the 
discussion of the LISTADR operand in this section. 

CHECK: Specifies the symbolic address of a user-written routine to 
which control is passed if any error is detected during the OPEN 
operation. The user-written routine is given control whenever TCAOCTR 
in the TCA contains a nonzero return code. It is the responsibility 
of the user to examine the return code in the TCA and, if necessary, 
examine the individual error codes in the list that was built either 
by the user or by the expansion of the DFHOC macro instruction. The 
error code appears in the first byte of the third word of each entry 
in the parameter list. 

Upon return from the Dynamic Open/Close program, TCAOCTR may contain 
one of the hexadecimal codes: 

00 - No error 

FF - Invalid reguest 

or, if TCAOCTR contains neither of these codes, it will contain one or 
more of the following hexadecimal codes: 

80 - Open error 

40 - Close error 

20 - No space available for OPEN 

10 - Invalid control block name 

While performing the reguested service on the list of data sets, 
the individual error bytes in the list entry are filled with a 
hexadecimal 00 or with the proper error code each time an error is 
encountered. If more than one error is encountered while processing 
the parameter list, TCAOCTR reflects all the errors and may show a bit 
configuration different from those shown above. For example, if there 
are six data sets to be opened, if four are successfully opened, if 
one has an invalid control block identification, and if one has an open 
error, the TCAOCTR field contains a hexadecimal 90. 

When there is not enough main storage available to open any data 
sets, TCAOCTR contains a hexadecimal 20, and all the entries contain 
a fullword (four bytes) of zeros in the third word. 

CLOSE DATA SETS (CLOSE) 

The programmer can close a data set or series of data sets by issuing 
the 

DFHOC TYPE=CLOSE, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name, . . .) , * 
CHECK=symbolic address 

macro instruction. The DATASET, LISTADR, SYMBADR, and CHECK operands 
have the same significance as for the DFHOC TYPE=OPEN macro instruction. 
The DESTID operand is used as follows. 

DSETID: Specifies the names of the data sets to be closed. No suffix 
is required. Up to 255 data set names can be specified with a single 
use of this operand. 
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SWITCH DUMP DATA SETS (SWITCH) 

The programmer can switch from the dump data set currently being 
used to the alternate dump data set by issuing the 

DFHOC TYPE=SWITCH, * 

DATASET=DUMP 

macro instruction. This macro instruction causes the current dump data 
set r if open, to be closed, and the alternate dump data set to be 
opened. A TYPE=CLOSE, DATASET=DUMP macro instruction does not cause a 
switch but only closes the current dump data set. 

CONTROL SYSTEM MESSAGES 

During the course of CICS execution, certain exceptional conditions 
can occur of which system administration should be aware. These 
conditions cause control system messages to be sent to appropriate 
destinations through the CICS Transient Data Control facility. The 
user interested in this information should direct it to the desired 
gueue or log by defining the appropriate entries in the Destination 
Control Table (DCT) . 

Although these control system messages may be routed to an 

extrapartition output log, it is strongly recommended that the user 

route them to a terminal (preferably hard copy) so that appropriate 
administrative action can be taken. 

Control system messages that originate in the Terminal Abnormal 
Condition program (DFHTACP) are time stamped; that is, the time that 
the exceptional condition occurred is printed as part of the message. 
The time is expressed in the form "hhmmsss", where "hh" represents 
hours, "mm" represents minutes, and "sss" represents seconds to tenths 
of a second. Control system messages that originate in the Abnormal 
Condition program (DFHACP) are not time stamped. 

The system actions described in connection with the following 
messages are the default actions provided by DFHTACP. These system 
actions are subject to modification by the user-written Terminal Error 
program (DFHTEP) . 

In the CICS/DOS-ENTRY system, it is not always possible to determine 
the transaction identification. Therefore, in the following message, 
the program identification (PROG yyyyyyyy) may be substituted for the 
transaction identification in the case of the CICS/DOS-ENTRY system. 

1. TCT SEARCH ERROR ON LINE W/TERM xxxx, hhmmsss 

TCT SEARCH ERROR ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

P estination: C S M T 

Explanati on: BTAM input only. An invalid terminal address was 
received for a read operation on a line defined by terminal 
xxxx. If the line supports the TWX, relative line zz is also 
printed. 

System Action:. Terminal request for service is ignored and the 
data which was input is lost. The line associated with terminal 
xxxx is placed out of service on non-switched lines; the system 
continues polling other lines. On remote 2260 terminals, the 
control unit skip flag is turned on in the polling list and the 
line continues in service. 
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Programmer Action: Examine the Terminal Control Table to be 
sure there is an entry for every terminal on each line. 
Regenerate it to include a missing terminal. Bad transmission 
of data on remote 2260 terminals can cause this message to occur. 

2. TRANSLATE ERROR AT TERM xxxx, TRANS yyyy, hhmmsss 
TRANSLATE ERROR ON LINE W/TERM xxxx, hhmmsss 

TRANSLATE ERROR ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Dsstination.L CS MT 

Expla nati on: BTAM. Terminal type for Terminal Identification 
xxxx is not present in the Terminal Control Table, or the 
Terminal Control program was not generated to support the device 
type specified in the Terminal Control Table. 

S yst em Ac tion : Request for service is ignored and the data is 
lost. The system continues polling. Terminal xxxx is put out 
of service. 

Programmer Acti on: Regenerate the Terminal Control Table to 
provide the correct terminal type, or regenerate the Terminal 
Control program to support the required terminal type. 

3. POLLING LIST ERROR ON LINE W/TERM xxxx, hhmmsss 

Desti nati on: CSMT 

Explanation: The address for a terminal identified as xxxx in 
the Terminal Control Table does not correspond to the polling 
list. 

S yst em Action^ The system continues processing. Terminal xxxx 
is put out of service. 

Programmer Action: Examine the Terminal Control Table and 
polling list for discrepancies. If the assemblies of each are 
correct, check to see if the program has inadvertently affected 
either the table or the list. Correct the error and either 
regenerate the table or resubmit the program. 

4. OUTPUT EVENT REJECTED AT TERM XXXX, TRANS yyyy, RETURN CODE zz, 
hhmmsss 

Destination: CSMT 

.Expla nation : BTAM output only. The return code zz was generated 
by BTAM when the write was attempted. 

System Action: The line (defined by terminal xxxx) is placed 
out of service, and the transaction yyyy is abended. 

Pr ogramme r Action: Take appropriate action as determined from 
the BTAM return code. 



5. INPUT EVENT REJECTED AT TERM xxxx, TRANS yyyy, RETURN CODE zz, 
hhmmsss 

INPUT EVENT REJECTED ON LINE W/TERM xxxx RETURN CODE zz, hhmmsss 
INPUT EVENT REJECTED ON LINE W/TERM xxxx, RELATIVE LINE aa, 
RETURN CODE zz, hhmmsss 
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D estination: C S H T 

Explanation^. BTAM input only. Return code zz was generated by 
BTAM when the READ was attempted. 

System Action^ The line defined by terminal xxxx and relative 
line aa (for switched lines) is placed out of service. The 
transaction yyyy is abended. 

Programmer Ac tio n: Take appropriate action as determined from 
the BTAM return code. 

6. TCT CODING OR TCP PROGRAM ERROR AT TERM xxxx, TRANS yyyy , hhmmsss 
TCT CODING OR TCP PROGRAM ERROR ON LINE W/TERM xxxx, hhmmsss 

TCT CODING OR TCP PROGRAM ERROR ON LINE W/TERM XXXX, RELATIVE 
LINE aa, hhmmsss 

Desti nati on: CSTL 

Explanation:. Generated as a result of a BTAM return code of 04 
(BUSY), OC (invalid OPTYPE) , or 1 (AUTOPOLL or program polling 
error) . 

S_ystem Action: None. 

Programmer Action: To further analyze the BTAM READ/WRITE return 
code, see the publication OS/360 B asi c Telecommunications Access 
Method, Version 2 (GC 30- 2 004) . 

7. OPEN FAILURE, USE LOPEN TO RECOVER ON LINE W/TERM xxxx, hhmmsss 
OPEN FAILURE, USE LOPEN TO RECOVER ON LINE W/TERM XXXX, RELATIVE 
LINE aa, hhmmsss 

Destination: CSTL 

Explanation: Generated as a result of BTAM return code 14 (line 
error during OPEN) . 

System Ac tio n: None. 

Pr ogramme r Action^ Use the Master Terminal facility to place 
the line in service. 

8. MISSING DD CARD ON LINE W/TERM xxxx, RELATIVE LINE aa, hhmmsss 

Destination: CSTL 

E xpla nation: Generated as a result of BTAM return code 08 
(invalid RLN) . This error most commonly occurs as a result of 
omitting one of the DD cards of a switched-line pool. 

S ys tem Ac tio n: None. 

Programmer Ac tio n: Ensure that all DD cards for a switched- 
line pool are present in the job stream used to bring up CICS. 

9. SHOULD NOT OCCUR RETURN CODE zz AT TERM xxxx, TRANS yyyy, hhmmsss 
SHOULD NOT OCCUR RETURN CODE zz ON LINE W/TERM xxxx, hhmmsss 
SHOULD NOT OCCUR RETURN CODE zz ON LINE W/TERM XXXX, RELATIVE 
LINE aa, hhmmsss 
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Desti nati on:, CSTL 

Ex pla n ati on^ Generated as a result of BTAM return codes 18, 
1C, or 20. These return codes are undefined for CICS and 
indicate that the DCB probably contains dynamic buffering 
operands. 

JLZstem Action^ None. 

Pr ogramme r Action:, Ensure that no buffering operands exist in 
the DCB for the line involved. 

10. BUFFERED DEVICE BUFFER EXCEEDED AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSTL 

Expla nati on: On a device with the buffer receive feature (for 
example, the 2740-2) , the output message length exceeded the 
hardware buffer size. 

System Action^ The write request is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

Pr ogra mmer Action: Ensure that the data length plus the carrier 
control characters does not exceed the hardware buffer size. 



11. OUTPUT LENGTH ZERO AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSMT 

Explana ti on: A write was requested on terminal xxxx by 
transaction yyyy/ but the contents of the TIOATDL field was 
zero. 

System Action^ The write request is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

Programmer Action: Ensure that the transaction in error 
initializes the TIOATDL field of the TIOA. 

12. NO OUTPUT AREA PROVIDED AT TERM xxxx, TRANS yyyy, hhmmsss 

Desti nati on: CSTL 

Explanation: A write was requested on terminal xxxx by 
transaction yyyy; the TCTTEDA field was not initialized. 

S yst em Action: The write request is aborted and the task is 
abended. 

Prog ramm er Ac tio n: Ensure that the transaction in progress 
obtains necessary storage and initializes the TCTTEDA field, as 
necessary. 

13. OUTPUT AREA EXCEEDED AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination^. CSTL 

Ex pla nation: The Terminal I/O Area (TIOA) was not large enough 
to contain both the data and carrier control characters. 
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System Action:, The write request is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

Pr ogramm er Actio n: Ensure that the transaction in error obtains 
TIOA's large enough to contain messages in addition to carrier 
control characters. 



14. UNIT CHECK AT TEEM xxxx, TRANS yyyy, hhmmsss 
UNIT CHECK ON LINE W/TERM xxxx, hhmmsss 
UNIT CHECK ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destination: CSMT 

Explanation: A unit check error occurred on the line defined 
by terminal xxxx, transaction yyyy, and relative line zz (as 
appropriate) . 

System Action: The line is placed out of service on GAM or SAM 
lines and on BTAM I/O errors (with the exception of Intervention, 
Data Check, or Time Out error conditions) . 

Intervention on a switched line causes the task to be abended 
and the line to be logically disconnected. Intervention on a 
non-switched line with a dummy (unidentified) terminal causes 
the line to be placed out of service; with a real terminal, 
causes the terminal to be placed out of service and the 
transaction (task) to be abended. 

Data check with a dummy terminal causes the line to be placed 
out of service; with a real terminal, causes the terminal to be 
placed out of service and the transaction to be abended. 

Time Out on a Read Text command causes a MESSAGE TOO LONG 
response to be sent to the terminal. Time Out with a dummy 
terminal causes the line to be placed out of service; with a 
real terminal, causes the terminal to be placed out of service 
and the transaction to be abended. 

Program me r Acti on: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



15. UNIT CHECK SHOULD NOT OCCUR AT TERM xxxx, TRANS yyyy, hhmmsss 

UNIT CHECK SHOULD NOT OCCUR ON LINE W/TERM xxxx, hhmmsss 

UNIT CHECK SHOULD NOT OCCUR ON LINE W/TERM XXXX, RELATIVE 

LINE zz, hhmmsss 

Destination: CSMT 

Expla nat ion:. A unit check error (which is undefined by BTAM) 
occurred on the line defined by terminal xxxx, transaction yyyy, 
and relative line zz (as appropriate) . 

Syste m , A ction:. The line is placed out of service on GAM or SAM 
lines and on BTAM I/O errors (with the exception of Intervention, 
Data Check, or Time Out error conditions) . 

Intervention on a switched line causes the task to be abended 

and the line to be logically disconnected. Intervention on a 

non-switched line with a dummy (unidentified) terminal causes 

the terminal to be placed out of service and the transaction 

(task) to be abended. 
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Data check with a dummy terminal causes the line to be placed 
out of service; with a real terminal, causes the terminal to be 
placed out of service and the transaction to be abended. 

Time Out on a Read Text command causes a MESSAGE TOO LONG 
response to be sent to the terminal. Time Out with a dummy 
terminal causes the line to be placed out of service; with a 
real terminal, causes the terminal to be placed out of service 
and the transaction to be abended. 

Programmer Actio n^ Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

16. UNIT EXCEPTION AT TERM xxxx, TRANS yyyy, hhmmsss 
UNIT EXCEPTION ON LINE W/TERM xxxx, hhmmsss 
UNIT EXCEPTION ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destin ation : C S M T 

Expla nat ion;. A unit exception error occurred on the line defined 
by terminal xxxx, transaction yyyy, and relative line zz (as 
appropriate) . This error was posted 41 by BTAM. 

Sy stem Action: With a switched line, the transaction is abended 
and the line is logically disconnected. With a dummy terminal, 
the line is placed out of service; with a real terminal, the 
terminal is placed out of service and the transaction is abended. 

Programmer Action: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



17. UNIT EXCEPTION SHOULD NOT OCCUR AT TERM xxxx, TRANS yyyy, hhmmsss 

UNIT EXCEPTION SHOULD NOT OCCUR ON LINE W/TERM xxxx, hhmmsss 

UNIT EXCEPTION SHOULD NOT OCCUR ON LINE W/TERM XXXX, RELATIVE 
LINE zz, hhmmsss 

Destina tion : CSMT 

E xplanation: A unit exception errror (undefined by BTAM) 
occurred on the line defined by terminal xxxx, transaction yyyy, 
and relative line zz (as appropriate) . 

System Ac tio n^ With a switched line, the transaction is abended 
and the line is logically disconnected. With a dummy terminal, 
the line is placed out of service; with a real terminal, the 
terminal is placed out of service and the transaction is abended. 

Programmer Action: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



NEGATIVE RESPONSE AT TERM xxxx, TRANS yyyy, hhmmsss 

NEGATIVE RESPONSE ON LINE W/TERM xxxx, hhmmsss 

NEGATIVE RESPONSE ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destination: CSMT 

Ex p lanat ion: An invalid negative response occurred on the line 
defined by terminal xxxx, transaction yyyy, and relative line 
zz (as appropriate) . 
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S yst em Ac tion : The terminal is placed out of service and the 
transaction is abended. 

Program me r Ac tio n: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



19. UNDETERMINED UNIT ERROR AT TERM xxxx, TRANS yyyy, hhmmsss 
UNDETERMINED UNIT ERROR ON LINE W/TERM xxxx, hhmmsss 
UNDETERMINED UNIT ERROR ON LINE W/TERM xxxx, RELATIVE LINE zz, 
hhmmsss 

Destin ati on: CSMT 

Explanation:, An I/O error (which was not unit check, unit 
exception, or negative response) occurred on the line defined 
by terminal xxxx, transacton yyyy, and relative line zz (as 
appropriate) . 

S yst em Action^ The line associated with terminal xxxx is placed 
out of service. 

Programmer Actio n: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



20. SECURITY VIOLATION HAS BEEN DETECTED TERM ID=xxxx, TRANS ID=xxxx, 
OPERATOR NAME=xxxxxxxx 

Destination! CSMT 

Explan at ion: The operator at terminal xxxx has requested a 
transaction whose security key does not match the corresponding 
security key for the operator who is signed on. 

System Action^ Continues polling cycle. 

Programmer Action; Determine whether the operator should be 
allowed to request the transaction. If so, correct the security 
key for the operator in the Sign-on Table (DFHSNT) . 

21. INTERCEPT REQUIRED AT TERM xxxx, TRANS yyyy, hhmmsss 

Desti nati on: CSMT 

Explanation: The task associated with terminal xxxx, transaction 
YYYY* a nd relative line zz (as appropriate) was to have been 
abnormally terminated, but TPURGE=NO was specified in the 
corresponding entry of the Program Control Table (PCT) . 

Sy st em Action: The terminal is placed out of service. 

Programmer Action: Use the Master Terminal facility to intercept 
or terminate the task. 
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22. TRANSACTION xxxx ABEND xxxx AT xxxx 



Destination: 



CSMT 



Explanation: The identified transaction attached to the 
identified terminal has been abnormally terminated. The ABEND 
code indicates the origin or cause, and may be originated by 
the user or by CICS. Following are the ABEND codes for abnormal 
terminations initiated by CICS. 



Code 
AACA 

AICA 



D etec ting Progr am Cause 
Abnormal Condition 



Interval Control 



AKCA 



Task Control 



AKCD 



Task Control 



AKCP 



Task Control 



Invalid error code passed to DFHACP 
in the TCA at location TCAPCABR. A 
complete system dump is provided to 
assist in problem determination. 

A runaway task condition has been 
detected and the task is being 
abnormally terminated. The condition 
indicates a possible logical loop 
within the user's program. 

Another CICS task has reguested Task 
Control to abnormally terminate this 
task as a result of actions initiated 
by: 

• Terminal Abnormal Condition program 

(DFHTACP) ; the appropriate message 
is found at destination CSMT. 

• Task Termination portion of 
the Master Terminal facility. 

The Asynchronous Transaction Control 
program (DFHATP) terminates 
asynchronous tasks when: 

• User reguests deletion of a batch 
via CWTR delete option while CICS 
is actively processing that batch; 
DFHATP abnormally terminates the 
task and purges all remaining data 
from the gueues. 

• An asynchronous task tries to read 
more data than is available; 
DFHATP abnormally terminates the 
task. 

Invalid code in the dispatch control 
indicator field. The invalid code 
can be found in the TCA at symbolic 
location TCATCDC. Valid Codes: 
X'10 1 Not dispatchable (not 

applicable to CICS/DOS-ENTRY) 

Dispatchable 

Wait on list of events 

Wait on single event 



X»20» 
X«40' 
X'80' 



A stall condition has been detected 
and this task is being abnormally 
terminated. This task carries a 
code indicating it is purgeable. 
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Code Detecting Pr o g ram 
AKCR Task Control 



Cause 

The type of request code is invalid. 
The invalid code can be located in 
the TCA at symbolic location TCATCTR. 
Valid Codes: 



AKCS Task Control 



APCC Program Control 



APCI Program Control 



APCL Program Control 



APCP Program Control 



APCR Program Control 



X'01' 
X»02' 
X'04' 
X'08' 
XMO' 
XM1' 
XM2 1 
XM4» 
X^O' 
X'40' 

x'so* 



Enqueue 

Dequeue 

Reserved 

Reserved 

Task Origination 

Reserved 

Reserved 

Reserved 

Priority Change 

Task Wait 

Task Termination 



The request exceeds available Subpool 
1 storage. CICS/DOS-ENTRY only. 

An attempt was made to execute an 
ANS COBOL program but ANS COBOL 
support was not generated in Program 
Control. 

An attempt was made to execute a 
PL/I program but PL/I support was 
not generated in Program Control. 

There is insufficient main storage 
available for the requested program. 

An error occurred on the read of a 
requested program from the library. 

Task request for service is invalid. 
The invalid code can be located in 
the TCA at TCAPCTR. Valid Codes: 



APCT Program Control 



APIA Program Interrupt 



ASCR Storage Control 



X'01 1 


LINK 


X'02 1 


XCTL 


X'04» 


LOAD 


X'08» 


DELETE 


X'10« 


RETURN 


X»40' 


ABEND 


x»60' 


ABEND with DUMP 


X^O' 


RETURN from Task 




Control program 



A task issued a request for a program 
which is not in the PPT. The invalid 
program ID is in the TCA at TCAPCPI. 

A program check has occurred during 
the subject task execution. The 
PSW at the time of interrupt is 
saved in the task's TCA. 

The request for service is invalid. 
Valid codes: 

X^O* Released Storage 
X'40* Release Storage 
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Code 



Detecting Prog ram Cause 



ASCT 



ATDI 



Storage Control 



Transient Data 



ATDT Transient Data 



DLDY DL/I Interface 



DLIA DL/I Interface 



DLPA DL/I Interface 



X'80 1 Acguire Storage 

The reguest exceeds available Subpool 
1 storage. CICS/DOS-ENTRY only. 

The type of destination code is 
invalid. The invalid code can be 
located in the DCT at symbolic 
location TDDCTDT. Valid Codes: 

X'20« Indirect 
X'40« Extrapartition 
X'80' Intrapartition 

Request for service is invalid. The 
invalid code is in the TCA and can 
be located at TCATDTR. Valid codes; 

X'20 1 Forced end of volume on 
extrapartition data set. 

X'UO* Output service on 
intrapartition. 

X*80' Input service on 
intrapartition. 

A DL/I CALL was issued, but the DL/I 
Interface dummy program under CICS/OS 
was loaded at system initialization. 

An irrecoverable error occurred 
during execution of the CICS-DL/I 
Interface program under CICS/OS. 
The DLIA code is returned to all 
transactions from which DL/I CALL'S 
are subseguently issued. 

A DL/I abend (or pseudo abend) 
occurred during transaction 
processing. The ABEND code is found 
in the TCA at TCADLECB. 



System Ac tio n; In addition to the dump services requested by 
application programs, CICS also requests dumps for abnormal 
conditions and places specific dump codes in the dumps for ready 
identification. 



A cti on: 
code. 



Analyze the error condition indicated by the abend 



23. INVALID COPY REQUEST AT TERM xxxx, TRANS yyy, hhmmsss 
Des tinati on:, CSMT 

Ex planati on: 

a. The Terminal Control Table Terminal entry of the "from" 
device did not specify the COPY feature. 

b. The device address specified for the "from" device 
does not exist on the requested control unit. 

c. The length specified for the COPY request was not one. 
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System Action: The transaction is abended. 

Progr amm er, Action^ Ensure that the application program is aware 
of the device configuration as necessary. 

24. INVALID MSG BLOCK ON LINE W/TERM xxxx, hhmmsss 
Destination: C S M T 

Explanation:, 

a. An unidentifiable message was received from a remote 3270 
device. The message block did not correspond with known 
identification patterns. 

b. The type of data block received from a 3735 was incorrect 
for the mode of the active CICS transaction. For example 

an inquiry message block was received for a batch transaction 
or conversely. This will probably occur if the 3735 is 
disconnected during a transaction and, upon reconnection, 
the operator initiates a different mode of operation. 

System, Act ion : The terminal is placed out of service and the 
transaction is abended. 

P£g.gg§IHBgg Action: For condition (a) , ensure that the hardware 
difficulty is corrected. For condition (b) , ensure that the 
terminal operator understands the correct operating and recovery 
procedures for 3735 transactions. 

25. INCMPLT MSG BLOCK ON LINE W/TERM xxxx, hhmmsss 
INCMPLT MSG BLOCK AT TERM xxxx, TRANS yyyy, hhmmsss 

De stinati on: C S M T 

Exp lanation : An incomplete message was received on term xxxx; 
that is, end of transmission was received prematurely or prior 
to end of text. 

System Ac tio n: The terminal is placed out of service and the 
transaction is abended. 

Programmer. Action: Ensure that the hardware difficulty is 
corrected. 

26. INTERV ON PRINTER ON LINE W/TERM xxxx, hhmmsss 
INTERV ON PRINTER AT TERM xxxx, TRANS yyyy, hhmmsss 

Dest inati on:. CSMT 

Expla nat ion:. This message is sent to the 3270 Information 
Display System on a printer intervention situation: 

a. Normal out of paper condition, cover open, offline, etc. 

b. No printer present, but transaction request to start printer. 

c. Printer adapter feature not present. 

System Action: No action is performed. 

Pr ogramme r Ac tio n: Ensure that the Terminal Control Table is 
properly defined and that the transaction requests proper printer 
operations. If the 3277 Display Station is plugged in the wrong 
position on the 3270 Information Display System, the operator 
may depress the CLEAR key to proceed. 



172 



27. INTERV REQUIRED ON LINE W/TERH xxxx, hhmmsss 
INTERV REQUIRED AT TERM xxxx, TRANS yyyy, hhmmsss 

P§stinaticn^ CSMT 

Explanation^ This message occurs when an intervention situation 
arises on the 3270 Information Display System. 

S^stera_Actionj. No action is performed 

Programmer Action: Correct the intervention situation. 

28. ERROR STATUS MSG eeee RECEIVED CN LINE w/TERM xxxx, hhmmsss 
ERROR STATUS MSG eeee RECEIVED AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination^ CSMT 

Explanation: BTAM error status message "eeee" was received from 
a remote 3270 Information Display System cr from a 3735 
Programmable Buffered Terminal. For a remote 3270, an 
"intervention reguired" condition causes an INTERVENTION REQUIRED 
message in lieu of this message. 

S;ystem_Action_: The transaction is abended and the terminal is 
placed out of service; however, if operation check status is 
present and if the terminal is a 3270, the terminal is left in 
service. 

P£23£§!J5er_ActioiK Analyze the error status to determine the 
proper course of action tc correct the unit error' or program 
error. 



29. UNSOLICITED INEUT ONLINE W/^EHM xxxx, hhmmsss 

Destination: CSMT 

Explanation: Input has occurred on a control unit (general 

poll) for which the associated terminal is "out of service" or 

has a task that has not issued a DFHTC TYPE=READ macro 
instruction. 

Sy ste m Action: No action is performed by CICS. Control is 
given to user-written DFHTEP. 

PloSIIiJUJer Action: Code DFHTEP as dictated by environmental 
needs. 



30. DESTINATION dddd INVALID ONLINE W/TERM xxxx, hhmmsss 

DESTINATION dddd INVALID AT TERM xxxx, TRANS yyyy, hhmmsss 

destination: CSTL 

Explanation: An application program has attempted to write to 
an invalid TCAM destination. 

System Action: Abend the transaction and abort the write 
reguest. 

Pl93£amraer Action: Ensure that application programs write to 
proper TCAM destinations. 
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31. INVALID READ REQUEST AT TERM XXXX, TRANS yyyy, hhmmsss 
Destination: CSHT 

J x£l5J3 a t i c n : 

a. A transaction has requested a READ from a terminal that 
presently has a terminal status of RECEIVE. 

b. A transaction has issued a READ request to a 3735 terminal 
during batch transmission after receipt of the end-of-file 
(EOF) condition. 

Sy ste m Action; Abort the READ request and abend the transaction. 

Progra mm er Action; For condition (a) , ensure that transactions 
dc not issue DFHTC TYPE=READ macro instructions to terminals in 
RECEIVE status. For condition (b) , ensure that the 3735 batch 
transaction makes proper use of the EOF operand in the DFHTC 
macro instruction so that no reads are issued after the EOF 
condition has occurred. 

32. INVALID WRITE REQUEST AT TERM XXXX, TRANS yyyy, hhmmsss 
Destination: CSHT 

Explanation : 

a. A transaction has issued a WRITE to a terminal that presently 
has a terminal status of INPUT. 

b. A transaction has issued a WRITE to a 3735 during batch 
transmission prior to receipt of the 'EOF 1 condition. 

Sy ste m Action: Abort the WRITE request and abend the 
transaction. 

Program me r Action: For condition (a) , ensure that transactions 
dc not issue WRITE requests to terminals in INPUT status. For 
condition (b) , ensure that the 37 35 batch transaction does not 
issue its first WRITE request before receiving the EOF condition. 

33. TIME OUT ONLINE W/TERM xxxx, hhmmsss 

TIME OUT AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSMT 

Explanation: A 32-second timeout has occurred on a 7770 Audio 
Response Unit. 

System Ac tio n: The 7770 terminal received an error message and 
is disconnected, and the transaction abended. 

Programmer Action: None 

3U. DFHSF001 xsx yyyyy zzz 

Destination: CSML 

Explanation: The operator has signed off a terminal where: 

xxx , = operator identification from Sign-on Table; 
yyyyy = number of transactions processed; 
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zzz 



= number of transaction errors. 



System Action: CICS continues processing. The operator is no 
longer signed on the terminal. The message SIGN OFF IS COMPLETE 
is returned to the terminal. 

Pr ogram mer Action: None 



175 



APPENDIX Aj. REQUIRED ENTRIES TO CICS CONTROL TABLES 



ENTRIES REQUIRED IN DESTINATION C ONT ROL TABLE (DCT) 

The following destination identification entries are required and 
must be provided by the user in the DFHDCT TYPE=EXTRA, DFHDCT 
TYPE=INTRA, or DFHDCT TYPE=INDIRECT specification: 

1. DESTID=CSMT The Terminal Abnormal Condition program (DFHTACP) 

and Abnormal Condition program (DFHACP) write 
terminal error and abend messages, respectively, 
to this destination. 

2. DESTID=CSTL DFHTACP writes terminal I/O error messages to 

this destination. 

3. DESTID=CSSL Statistics programs write data to this 

destination. 
U. DESTID=CSML Sign-off program outputs data to this 

destination. 

If the Transient Data Control program (DFHTDP) is not included in 
the generation of CICS, messages to these destinations are lost 
(ignored) . 

ENTRIES REQUIRED IN PROGRAM CONTROL TABLE (PCT) 

The following entries are required in the PCT and must be provided 
through the DFHPCT TYPE=ENTRY macro instruction. Minimum values for 
TWASIZE are indicated. 

TRANSID PROGRAM TWASIZE 

CAQP*** DFHAQP 100 

CATP*** DFHATP 100 

CRDR*** DFHRD1 100 

CSAC DFHACP 40 

CSFE** DFHFEP 100 

CSMT** DFHMTPA 160 

CSOT** DFHMTPA 100 

CSSF** DFHSNP 

CSSN** DFHSNP 

CSST** DFHMTPA 100 

CSTA** DFHTAJP 

CSTE DFHTACP 

CSTT DFHSTKC 100 

CWTR*** DFHWT1 160 

8888* DFHSNP 

9999* DFHSNP 

Note: Entries marked with a single asterisk are required only when 
numeric-only terminals are used to sign on. 

Entries marked with a double asterisk are required only when 
the associated program is desired. 

Entries marked with a triple asterisk are required only when 
the Asynchronous Transaction Processing facility is being used. 

Any transaction codes specified for the TRANSID parameter in any 
DFHTCT TYPE=TERMINAL macro instruction must also be included in the 
PCT. 
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Transaction code CSXX is reserved for 3270 support and should not 
be generated in the PCT. (CSXX is used to generate an "invalid 
transaction code" message when a zero length data message is received.) 

The user-assigned transaction security key for entries CSAC, CSSN, 
and CSSF must always be the value 1. 

A high priority (for example, 255) is recommended for transactions 
CSAC, CSTA, CSMT, CSOT, and CSST. A low priority (for example, 001) 
is recommended for transactions CSFE, CSSF, CSSN, and CSTT. 

CSMT, CSOT, and CSST do not run in 2260 compatibility mode. 
COMPAT=NO must be specified or the operand omitted. 

ENTRIES REQUIRED IN PROCESSING PROGRAM TABLE (PPT) 

The following entries are required in the PPT and must be provided 
through the DFHPPT TYPE=ENTRY macro instruction: 



PROGRAM NAME 

DFHACP 

DFHAQP 



DFHATP 



DFHBMSMM 



DFHFEP 

DFHMTPA 
DFHMTPB 
DFHMTPC 
DFHMTPD 
DFHMTPE 
DFHMTPF 

DFHOCP 



DFHRD1 
DFHRD2 



DFHSFP 

DFHSNP 

DFHSNT 

DFHSTKC 
DFHSTP 



USAGE 

Abnormal Condition program. 

Asynchronous Queue Purge program (required only 
if the Asynchronous Transaction Processing 
facility is being used) . 

Asynchronous Transaction Control program 
(required only if the Asynchronous Transaction 
Processing facility is being used) . 

Basic Mapping Support program (required only if 
3270 Basic Mapping support is desired) . 

Terminal Test program (optional) . 

Master Terminal program (required only if master 
terminal or system termination functions are 
desired) . 



Dynamic Open/Close program (required only if 
dynamic open/close facility is desired) . 

Asynchronous Transaction Input Processing 
programs (required only if the Asynchronous 
Transaction Processing facility is being used) . 

Sign-off program linked to by DFHSNP (required 
only if sign-on/sign-off function is desired) . 

Sign-on program (required only if sign-on/sign- 
off function is desired) . 

Sign-on Table (required only if sign-on/sign-off 
function is desired) . 

System Statistics program. 

System Termination program linked to by DFHMTP. 
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PROGRAM NAMI 
DFHSTTD 

DFHSTTR 

DFHTACP 
DFHTAJP 

DFHTDCP 

DFHTEP 
DFHTRNXX 



DFHWT1 
DFHWT2 



DFHXITxx 



User-specified 
name 



USAGE 

Transient Data and Temporary Storage Statistics 
program linked to by DFHSTKC. 

Terminal and Data Base Statistics program linked 
to by DFHSTKC. 

Terminal Abnormal Condition program. 

Optional Time Adjustment program that 
automatically adjusts the date and time of day 
maintained by CICS to reflect the date and time 
of day maintained by the operating system. 

Device-Dependent Output program for 1030 
terminals. 

Terminal Error program linked to by DFHTACP. 

non-resident data set control blocks as specified 
by the user in DCT. 

Asynchronous Transaction Output Processing 
programs (required only if the Asynchronous 
Transaction Processing facility is being used) . 

User-written exit routine used with Asynchronous 
Transaction Processing transactions CRDR and 
CWTR. 

User-written program to edit input data and 
transfer control to the appropriate transaction. 
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APPENDIX B: EXAMPLES OF TERMINAL CONTROL TABLE PREPARATION 



This section illustrates the coding required to prepare the CICS 
Terminal Control Table (TCT) . The terminal network described includes: 

1. Start/stop transmission 

a. Multipoint line (serving more than one terminal) 

(1) 1030 Data Collection System 

(2) 2260 Display Station (remote) 

b. Point-to-point line (serving only one terminal) 

(1) 2740 Communication Terminal and 2760 Optical Image Unit 

(2) 2741 Communication Terminal with correspondence code 

c. Switched line (dial-up) 

(1) 7770 Audio Response Unit under CICS/OS 

(2) 7770 Audio Response Unit under CICS/DOS 

(3) Common Carrier Teletypewriter Exchange Terminal (TWX) 

2. Binary synchronous transmission 

a. Multipoint line (serving more than one terminal) 

(1) 2980 General Banking Terminal System 

(2) 3270 Information Display System (remote) 

b. Point-to-point (serving only one terminal) 
(1) 2780 Data Transmission Terminal 

c. Switched line (dial-up) 

(1) 2770 Data Communication System 

(2) System/3 

(3) 3735 Programmable Buffered Terminal (CICS/OS only) 

3. Transmission via sequential devices 

a. Card reader/line printer 

(1) 2540 Card Read Punch and 1403 Printer 

b. Disk 

(1) 2314 Direct Access Storage Facility 

4. Transmission via devices locally attached 
a. Graphics devices 

(1) 2260 Display Station (local) 

(2) 3270 Information Display System (local) 

Each of the following is a functional example if as shown in the 
first example, (1) the DFHTCT TYPE=INITIAL macro instruction is inserted 
at the beginning of each example, (2) the DFHTCT TYPE=FINAL macro 
instruction is inserted at the end of each example, and (3) an Assembler 
END card that includes the operand DFHTCTBA is inserted following the 
DFHTCT TYPE=FINAL macro instruction. 

1030 DATA COLLECTION SYSTEM 



DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DEVICE=1030, * 

LINELST=(024) , * 

SWITCH=NO, * 
DSCNAME=DTF1030 
OPL1030 DFTRMLST OPENLST , (64 , 62) 

DFHTCT TYPE=LINE, 

ACCMETH=BTAM, * 

TRMTYPE=1030, * 

DSCNAME=DTF1030, * 

BTAMRLN=1, * 
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LISTADR=OPL1030, * 
INAREAL=120 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T30A, * 

TRANSID=1030, * 

TRMADDR=64, * 

TRMPRTY=202, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T30B, * 

TRANSID=1030, * 

TRMADDR=62, * 

TRMPRTY=201, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 

2260 DISPLAY STATION (REMOTE) 

DFHTCT TYPE=SDSCI, * 

CU=2701, * 

DEVICE=2260, * 

LINELST=(026) , * 

SWITCH=NO, * 
DSCNAME=DTF60R 
OPL2260 DFTRMLST OPENLST, (40FF, 4 1FF) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2260, * 

TRMMODL=3, * 

DSCNAME=DTF60R, * 

BTAMRLN=1, * 

LISTADR=OPL2260 / * 
INAREAL=960 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60A, * 

TRMADDR=40A0, * 

TRMPRTY=61, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60B, * 

TRMADDR=40A1, * 

TRHPRTY=62, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R530, * 

TRMTYPE=1053, * 

TRMADDR=40A4, * 

TRMPRTY=32, * 
TRMSTAT=RECEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R65A, * 

TRMTYPE=2265, * 

TRMADDR=4151, * 

TRMPRTY=64, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 

2700 COMMUNICATION TERMINAL/2760 OPTICAL IMAGE UNIT 

DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=2740, * 

FEATURE=(CHK,OIU) , * 
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LINELST=(029) , * 

SWITCH=NO, * 
DSCNAME=DTF40B 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2740/2760, * 

FEATURE=CHECKING, * 

DSCNAME=DTF40B, * 

INAREAL=120, * 
BTAMRLN=1 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T40C, * 

TRANSID=2760 / * 

TRMPRTY=202, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 



1H11 COMMUNICATION TERMINAL 

DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=2741C, * 

LINELST=(030) , * 

SWITCH=NO, * 
DSCNAME=DTF41C 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2741C, * 

DSCNAME=DTF41C, * 

INAREAL=120, * 
BTAMRLN=1 

DFHTCT TYPE=TSRMINAL, * 

TRMIDNT=T41A, * 

TRMPRTY=129, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 

2220 AUDIO RESPONSE Mil HIHR CIC5/0S 

DCB DFHTCT TYPE=SDSCI, * 

DEVICE=7770, * 

DSCNAME=DCB7770, * 
APPENDG=Z3 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770 r * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=1, * 

FEATURE=AUTOANSR r * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY r * 

ERRMSG=ERROR, * 
POOLADR=T17770 

L27770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770 f * 

DSCNAME=DCB7770, * 

INAREAL=256 r * 

BTAMRLN=2, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 
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CONVTAB=ABB, * 

RDYMSG=READY, * 
ERRMSG=ERROR 

L37770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=3, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 
ERRMSG=ERROR 

L47770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, - * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=4, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 
ERRMSG=ERROR 

T17770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7771, * 

TRMPRTY=30, * 

TRMTYPE=7770, * 
TRMSTAT=TRANSCEIVE 

T27770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7772, * 

TRMPRTY=30, * 

TRMTYPE=7770, * 
TRMSTAT=TRANSCEIVE 

T37770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7773, * 

TRMPRTY=30, * 

TRMTYPE=7770, * 
TRMSTAT=TRANSCEIVE 

T47770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7774, * 

TRMPRTY=30, * 

TRMTYPE=7770, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=POOL 

READY DFHTCT TYPE=7770MSG, * 
MESSAGE= , 001D0B» 

ERROR DFHTCT TYPE=7770MSG, * 
MESSAGE='000A0F' 

2220 M2I0 S1SPO NSE UNIT UNDER CICS/DOS 

DTF DFHTCT TYPE=SDSCI, * 

DEVICE=7770, * 

DSCNAME=DTF7770, * 

SWITCH=YES, * 

LINELST= (080,081,082,083) , * 

BLKSIZE=256, * 
FLNNAME=117770 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DTF7770, * 
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L27770 DFHTCT 



L37770 DFHTCT 



L47770 DFHTCT 



T17770 DFHTCT 



T27770 DFHTCT 



T37770 DFHTCT 



T47770 DFHTCT 



READY 
ERROR 



DFHTCT 
DFHTCT 



INAREAL=256, 

BTAMRLN=1, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYHSG=READY / 

ERRMSG=ERROR, 

POOLADR=T17770 

TYPE=LINE / 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=2, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=LINE / 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=3, 

FEATURE=AUTOANSR, 

ANSWRBK=TERI1INAL, 

CONVTAB=ABB, 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=4, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=TERMINAL, 

TRMIDNT=7771, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT=7772, 

TRHPRTY=30, 

TRKTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT=7773, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT=7774, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE, 

LASTTRM=POOL 

TYPE=7770MSG, 

HESSAGE='001D0B» 

TYPE=7770MSG, 
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MESSAGE='OOOAOF» 

COMMON C AERIES TELETYPEWRITER EXCHANGE TERMINAL (THX) 

DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DEVICE=TW35, * 

LINELST= (039) , * 

SWITCH=YES, * 
DSCNAME=TWXONE 
IDLTWX DFTRMLST IDLST, , 19, 01B1 5 1FFC393C3CB0 52BEB1BB15 1 E1 E1E 1E1 A1 
TWXIDA DFTRMLST IDLST r 7 , 493 1 683, 1 r 500AB222C3052B2B9 AB1 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM / * 

TRMTYPE=TWX, * 

DSCNAME=TWXONE f * 

INAREAL=120, * 

BTAMRLN=1, * 

LISTADR=IDLTWX, * 

FEATURE= (AUTOANSR, AUTOCALL) , * 

POOLADR=TWXAUTO, * 
ANSWRBK=AUTO 

TWXAUTO DFHTCT T YPE=TERMINAL, * 

TRMIDNT=TWXA, * 

TRMADDR=TWXIDA, * 

TRMPRTY=201, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=POOL 

2980 GENERAL BANKING TERMINAL SYSTEM 

DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=BSCMDMPT, * 

BSCODE=EBCDIC r * 

SWITCH=NO, * 
DSCNAME=DTF2980 
TCT29POL DFTRMLST AUTOWLST, (C1C1 F02D, 37373737) POLL CU 
TCT29PA1 DFTRMLST OPENLST, (8181 402D) ADDRESS STATION 1 
TCT29PA2 DFTRMLST OPENLST, (8 181F12D) ADDRESS STATION 2 
TCT29PA3 DFTRMLST OPENLST, (8 181F22D) ADDRESS STATION 3 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2980, * 

DSCNAME=DTF2980, * 

INAREAL=480, * 

BTAMRLN=1, * 

LISTADR= (TCT29POL r WRAP) , * 
FEATURE=AUTOPOLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T801, * 

STN2980=0, * 

TAB2980=04, * 

POLLPOS=01, * 

TRMADDR=TCT29PA1, * 

TRMMODL=1, * 

TRMPRTY=10, * 

TIOAL=200, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T802, * 

STN2980=1, * 

TRMADDR=TCT29PA2, * 
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TRMM0DL=2, 
TRMPRTY=10, 
TIOAL=200, 
TEHSTAT=TRANSCEIVE 
DFHTCT TYFE=TERMINAL, 
TRHIDNT=T803 / 
STN2980=2, 
TAE2980=02, 
TRMADDR=TCT29PA3, 
TRMM0DL=4, 
TRMPRTY=10, 
TICAL=200, 
TRMSTAT^RANSCEIVE, 
LASTTRM=LINE 



Note: This is a functional example for CICS/DOS if the 

(C1C1F02D, 37373737) parameters in the above TCT29P0L DFTRMLST 
statement are changed to 3732,C1C1F02D. 



3270 INFORMATION DISPLAY SYSTEM 



F0LL77 DFTRMLST AUTOWLST, (40 407F7F2D,C1 C17F7F2D, 3737373737) 
LSTR77A DFTRMLST CPENLST , (606040 402D) 
LSTR77B DFTRMLST OPENLST , (61 61 40402D) 
LSTR77C DFTRMLST CPENLST , (61 61C1 C1 2D) 
DFHTCT TYPE=SDSCI, 

DEVICE=BSCMDMPT, 

DSCNAME=REM0TE77, 

BSCODE=EBCCIC 
DFHTCT TYFE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=3277, 

LISTADR=(P0LL77,WRAP) , 

BTAMRLN=1, 

DSCNAME=REMOTE77, 

INAREAL=256, 

TRKMODL=2, 

FEAT0RE=AOTOPOLL 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77A, 

TRMMODL=1, 

TRMTYPE=3275, 

TRMADDB=LSTR77A, 

POLLPOS=1, 

CCMPAT= (480,12,2260,2) , 

FEATTJRE=PTRAEAPT, 

TICAL=500 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77B, 

TRMADDR=LSTR77B, 

POLLPOS=2, 

COMPAT= (960,15,2265,2) , 

FEATURE=(COPY,DCKYEE,SELCTFEN) , 

TICAL=1500 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77C, 

TRMTYPE=3286, 

FEATDRE=COPY, 

TRMADDR=LSTR77C, 

LASTTRM=LINE, 

TRMSTAT=TRANSCEIVE, 

TIOAL=1500 



Note: This is a functional example for CICS/DOS if (1) the (40407F7F2D, 
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C1C17F7F2D,37 37373737) parameters in the above P0IL77 DFTRMLIST 
statement are changed to 3732, 40407F7F2D, C1C17F7F2D, and (2) 
the LINELST= (029) and CD=2703 operands are included in the DFHTCT 
TYPE=SDSCI specification. 



2780 DATA TRANSMISSION TERMINAL 



DFHTCT TYPE=SDSCI, 

BSCOEE=EBCDIC, 

EDNAME=DDN2780, 

DEVICE=2780, 

DSCNAME=DCBN2780, 

CU=2703, 

LINELST=(023) , 

FEATURE= (BSC,SLV) , 

MODELST=0, 

CONFIG=PPT r 

SWITCH=NO, 

MACRF= (R,W) 

DFHTCT TYPE=LINE, 

TRMTYPE=2780, 
DSOAME=DCBN2780, 
ACCMETH=BTAM, 
ETAMRLN=1, 
BSCOEE=EBCDIC, 
INAREAL=520 
N2780 DFHTCT TYPE=TERMINAL, 
TRMIDNT=T80A, 
LASTTRM=LINE, 
TRMTYPE=2780, 
TICAL=100, 
TRMSTAT=TRANSCEIVE, 
TRMPRTY=126 



2770 DATA COMMUNICATION SYSTEM 



DFHTCT TYPE=SCSCI f 

BSCOEE=EBCBIC, 

DDNAME=DDD2770, 

DEVICE=2770, 

DSCNAMI=DCBD2770, 

MACRF= (R,W) , 

CU=2703, 

LINELST= (020) , 

FEATDRE= (BSC,SLV) , 

MODELST=0, 

CONFIG=PPT, 

SflITCH=YES 

DFHTCT TYPE=LINE, 

TRMTYPE=2770 r 
DSCNAME=BCBD2770, 
ACCMETH=BTAM, 
ETAMRLN=1 r 
BSCOEE=EBCBIC r 
FCCLADR=D2770, 
INAREAI=520, 
FEATURE=AUTOANSR, 
LISTaDE=LA2770 r 
ANSWRBK=TERMINAL 
D2770 DFHTCT TYPE=TERMINAL, 
TRMIDNT=D70A, 
LASTTRM=POOL, 
TICAL=100 / 
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TRMTYPE=2770, * 

TRMADDR=TA2770, * 

TRMSTAT=TRANSCEIVE, * 
TRMPRTY=126 

LA2770 DFTRMLST BSCLST, , 1 ,2D, 2, 1070 

TA2770 DFTRMLST BSCLST,0 ,2 , 1 070, 1 , 2D 

SYSTEM/3 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DDDSYS3, * 

DEVICE=SYS/3, * 

DSCNAMF=DCBDSYS3, * 

MACRF=(R r W) r * 

CU=2703,- * 

LINELST= (020) , * 

FEATURE=(BSC,SLV) , * 

MODELST=0, * 

CONFIG=PPT, * 
SUITCH=IES 

DFHTCT TYPE=LINE, * 

TRMTYPE=SYS/3, * 

DSCNAME=DCEDSYS3, *■ 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCOEE=EBCDIC, * 

EOCLADR=SYS3D, * 

INAREAL=500, 96 X 5 + 20 PAD * 

FEATDRE=AUTOANSR, * 

LISTADR=LASYS3, * 
ANSWRBK=TERMINAL 

SYS3D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DSY3, * 

LASTTRM=POOL, * 

TICAL=100 / * 

TRMTYPE=SYS/3, * 

TRMADDR=TASYS3, * 

TRMSTAT=TRANSCEIVE, * 
TRHPRTY=126 

LASYS3 DFTRMLST BSCLST, , 1 , 2D, 2, 1070 

TASYS3 DFTRMLST BSCLST, , 2 , 1 070, 1 , 2D 

3735 PROGRAMMABLE BUFFERED TERMINAL (Not applicable to CICS/DOS-Entry) 

DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDSW, * 

CD=2703, * 

3SCODE=EBCDIC, * 
DSCNAMF=DTF35D 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3735, * 

DSCNAME=DTF35D, * 

INAREAL=U80, * 

ETAMRLN=1, * 

LISTADR=LISTA, * 

FEAT0RE= (AUTCANSR, AUTOCALL) , * 

POCLADR=A3735, * 

BSCOEE=EBCDIC, * 
ANSflRBK=EXIDVER 

A3735 DFHTCT TYPE=TEBMINAL, * 

TRMIDNT=3735, * 
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TRHTYPE=3735, 

LASTTRM=P0OL, 

TRMADDB=LISTB, 

TRMSTAT=TRANSCEIVE, 

TRANSID=3735, 

TIOAL=476 
LISTA DFTRMLST SflLST , AN, 1 1 ,4 , 2, 1 070, (98F0F3F5182D, , A3735) 
LTSTB DF1RHLST SWLST, AD, 4 ,3374, 8, , 1 , 2D, (98F0F3F5181 C70 , 1) 



2540 CARD READ PDNCH/U03 PRINTER 



DFHTCT 


TYPE=SDSCI, 




DEVADDB=SYSIPT, 




DEVICE=2540, 




DSCNAME=READER 


DFHTCT 


TYPE=SDSCI, 




DEVADDR=SYSLST, 




DEVICE=1403, 




DSCNAME=PRINTER 


DFHTCT 


TYPE=LINE r 




ACCMETH=BSAH, 




TRHTYPE=CRIP, 




ISADSCN=READER, 




OSADSCN=PRINTER, 




INAREAL=80 


DFHTCT 


TYPE=TERMINAL, 




TRMIDNT=SAMA, 




TRMTYPE=CRLP, 




TRMSTAT=TRANSCEIVE 


2314 DIRECT ACCESS STORAGE FACILITY 



DFHTCT TYPE=SDSCI, 

DEVADDR=SYS001, 

DEVICE=2314, 

DSCNAME=DISKIN1 
DFHTCT TYPE=SDSCI, 

DEVADDR=SYS006, 

DEVICE=2314, 

ESCNAME=DISK0T1 
DFHTCT TYPE=LINE, 

ACCMETH=SEQOENTIAL, 

TRMTYPE=EASD, 

ISADSCN=DISKIN1, 

0SADSCN=DISK0T1, 

INAREAL=80 
DFHTCT TYPE=TERMINAL, 

TRMIDNT-SAMB,. 

TRMPRTY=11, 

TRMSTAT= (TRANSCEIVER OUT OF SERVICE 1 ) 



2260 DISPLAY STATION (LOCAL) 



DFHTCT TYPE=SDSCI, 
CD=2848, 
DEVICE=L2260, 
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LINELST=(021,022,023) , * 

FEATURE=KBL, * 

SWITCH=NO, * 

FLNNAME=LINE1 , * 
DSCNAHE=DTF60L 

LINE1 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, ACCMETH=BGAM FOR CICS/OS * 

TRMTYPE=L2260, * 

CLASS=VIDEO, * 

DSCNAME=DTF60L, * 

INAREAL=960, * 
FEATURE=KBRDLOCK 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L60A, * 

LVUNIT=1, * 

TRMPRTY=32, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L60B, * 

LVUNIT=2, * 

TRMPRTY=32, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L530 f * 

TRMTYPE=1053, * 

LVUNIT=3, * 

T3MPRTY=32, * 

TRMSTAT=RECEIVE, * 
LASTTRM=LINE 

3270 INFORMATION DIS PLA Y SYSTEM (LOCAL) 

DFHTCT TYPE=SDSCI, * 

DSVICE=L3277, * 
DSCNAME=L3270 

DFHTCT TYPE=LINE, * 

ACCMETH=3TAM, * 

DSCNAME=L3270, * 

TRMMODL=2, * 

TRMTYPE=L3277, * 

POOLADR=T010, * 

INAREAL=2500, * 
POOLCNT=2 

T010 DFHTCT TYPE=TERMINAL , * 

TRMIDNT=L77A, * 

LVUNIT=1, * 

FEATURE= (SELCTPEN,AUDALARM) , * 
COMPAT=(480, 12,2260, 2) 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77B, * 

LVUNIT=2, * 

TRMTYPE=L3277, * 

LASTTRM=POOL, * 
TRMSTAT=TRANSCEIVE 

Note: This is a functional example for CICS/DOS if (1) the CU=3272 
and LINELST= (030,031) operands are included in the DFHTCT 
TYPE=SDSCI specification, and (2) if the POOLCNT=2 operand is 
deleted from the DFHTCT TYPE=LINE specification. 
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APPENDIX C: CICS/TCAM PROGRAM INTERRELATIONSHIP 



The following illustrates the interrelationship between the TCAM 
Message Control program (MCP) and the TCAM Message Processing program 
(MPP) . CICS is regarded as a Message Processing program by TCAM. 



TCAM MCP 



CICS MPP 



2260 REMOTE: 




2260 LOCALS 





DD CARDS 


//QINI 


DD 


QNAME=RISI 


//QOUTI 


DD 


0NAME=WISI 


//R2260IN DD 


QNAME=R60I 


//R2260UT DD 


QNAME=R600 



TOCICS 

MESSAGE 
HANDLER 



QPROC 
PCB 



R60I 
TPROCESS 



R600 
TPROCESS 



RISI 
TPROCESS 



WISI 
TPROCESS 



ISDSCKDCB ) 



TCTLE 
DDNAME= 
R2260IN 



WW 




S65A 



WHITE 



SDSCKDCB) 



TCTLE 

DDNAME= 
QOUTI 



TRM2 



TRM1 
TCTTE 



The following is an example of a CICS Terminal Control Table and a 
TCAM Message Control program. 



CICS TERMINAL CONTROL TABLE 



DFHTCT TYPE=INITIAL,SUFFIX=TV 
DFHTCT TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=L1, 

DDNAME=QIN1, 

OPTCD=WU, 

MACRF=R, 

RECFM=U, 

BLKSIZE=500 
DFHTCT TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=L2 r 

DDNAME=Q00T1, 

OPTCD=WU, 

MACRF=W r 

RECFM=U, 
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DFHTCT 



DFHTCT 



ODTQ DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



OOTQ60 DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



BLKSIZE=500 

TYPE=LINE, 

ACCMETH=TCAM, 

QUFUEID=F1, 

INAREAL=500, 

TRMTYPE=L2260, 

DSCNAME=L1, 

OUTQ=OUTQ 

TYPE=TERMINAL, 

TRMIDNT=DMMY, 

TEMPHTY=32 / 

LASTTRM=LINE 

TYPE=LINE, 

ACCMETH=TCAM, 

QUEUEID=FO, 

INAREAL=500, 

TRMTYPE=L2260, 

ESCNAME=L2 

TYPE=TERMIML, 

TRMIDNT=TRM1, 

TRMPRTY=32 

TYPE=TERMINAL, 

TRMIDNT-TRM2, 

LASTTRM=LINE, 

TRMPRTY=32 

TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=R60IN, 

EDNAME=R2260IN, 

OPTCD=HU, 

HACRF=R, 

RECFM=0, 

BLKSIZE=500 

TYPE=SDSCI, 

DEVICE=TCAM, 

DSCHAME=R60OUT, 

DENAME=R260O0T, 

OPTCD=WU, 

MACRF=W, 

RECFM=U, 

BLKSIZE=500 

TYFE=LINE, 

ACCMETH=TCAM, 

INAREAL=500, 

DSCNAME=R60IN, 

OUTQ=ODTQ60, 

TRMTYPE=2260 

TYPE=TERMINAL, 

TRMIDNT=1260, 

TRHPRTY=32, 

LASTTRH=LINE 

TYPE=IINE r 

ACCMETH=TCAM, 

INAREAL=500, 

DSCNAME=R60OUT, 

TRMTYPE=2260 

TYPE=TERMINAL, 

TRMPRTY=32, 

TRMIDNT=S60A 

TYPE=TERMINAL, 

TRMPRTY=32, 

TRHIDNT=S60B 

TYPE=TERMINAL, 

TRMPRTY=32, 

TRMIDNT=S65A, 
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LASTTRM=LINE 
DFHTCT TYPE=FINAL 
END DFHTCTEA 



TCAM MESSAGE CONTROL PROGRAM 



MCPCICS 


CSECT 




TCAMINIT 


INTRO 


DISK=NO, 

PROGID=TCAM/CICS, 

LNUNITS=40, 

MSONITS=20, 

KEYLEN=133, 

CEOSSRF=4, 

DLQ=TRM1, 

STARTUP=CY r 

TRACE=10, 

LINETYP=BOTH r 

OLTEST=0 




LTR 


15,15 




BZ 


OPENLINE 


NOEXEC 


ABEND 


123, DUMP 


OPENLINE 


OPEN 


(LG2260, (INOUT) ,PG2260, (INOUT) ) 




TM 


LG2260+48,DCBOFLGS 




BNO 


NOEXEC 




TM 


PG2260+48,DCBOFLGS 




BNO 


NOEXEC 




WTO 


'TIME TO START APPLICATION PROGRAM' 



FINISH 


LG2260 



FG2260 



QPROC 



DCB 



PCB 





TTABLE 


RIS1 


TPROCESS 


WIS1 


TPROCESS 


R60I 


TPROCESS 


R600 


1EROCESS 


S60A 


TERMINAL 


S60B 


TERMINAL 


S65A 


TERMINAL 


TRM1 


TERMINAL 



(LG2260,,PG2260) 

13,4(13) 

(14,12) 

DSORG=TX, 

MACRF=(G,P) , 

CPRI=S, 

DENAME=DDLG2260, 

MH=TOTCAM, 

PCI=(N,N) , 

BUFSIZE=464, 

INVLIST= (POLLST1, , , POLLST2) ,TEANS = EBCD 

DSORG=TX,MACRF= (G,P) , CPRI=S, DDNAME=DDPG2260, 

MH=MH2260,PCI= (N,N) ,BUFSI ZE=464, 

INVLIST=(POLL60R,,) ,TRANS=2260 

MH=TOCICS, 

BUFSIZE=464, 

RESERVE=(20) 

LAST=TRM2 

PCB=QPROC, 
QUEUES=MO 

PCB=QPROC 

ECB=QPROC, QUEDES=MO 

PCB=QPROC 

QBY=T,ECB=PG2260,RLN=1,TERM=226R,QUEUES=MO, 
AEER=40A0E0FF 

QBY=T,DCB=PG2260,RLN=1,TERM=226R,QUEDES=MO, 
ABDR=40A1E0FF 

QBY=T,BCB=PG2260,RLN=1,TERM=2265,QUEUES=MO, 
AEDR=4151E0FF 

CBY=L, 
DCB=LG2260, 
RLN=1, 
TERM=226L, 
QUE0ES=MO, 
AEDR=IFFFFFFF, 
SECTERM=YES 
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TRM2 


TERMINAL QBY=L r 


* 






DCB=LG2260, 


* 






RLN=2, 


* 






TERM=226L, 


* 






ADDR=FFFFFFFF, 


* 






QUEUES=MO 




P0LLST1 


INVLIST 


ORDER= (TRM1+02) 




P0LLST2 


INVLIST 


ORDER= (TRM2+02) 




POLL60R 


INVLIST 


ORDER= (S6 0A+4 0A040,S6 0B+40A140,S6 5A+415140) 




TOTCAM 


STARTMH 

INHDR 

CODE 


LC=OUT 






FORWARD 


DEST=C I RIS1 1 




INMSG 


EQU 

INMSG 

INEND 

OUTHDR 

OUTEND 


* 




MH2260 


STARTMH 

INHDR 

CODE 


LC=OUT 






SETSCAN 


1 






MSGEDIT 


<(R,,SCAN)) 






FORWARD 


DEST=C , R60I' 






INMSG 








INEND 








OUTHDR 








SETSCAN 


1 






MSGEDIT 


((R,,SCAN)) 






MSGFORM 


BLOCK=460 






CODE 








OUTEND 






TOCICS 


STARTMH 

INHDR 

CODE 


LC=OUT 






FORWARD 


DEST=PUT 






INEND 








OUTHDR 








OUTEND 






DCBOFLGS 


EQU 

END 


X'10' 
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APPENDIX D: TERMINAL CONTROL TABLE CONFIGURATOR 



This section is intended to aid the system programmer in the 
preparation of the Terminal Control Table (TCT) as he uses operands of 
the DFHTCT macro instruction to: 

1. Specify data set control information 

2. Describe communication lines 

3. Describe terminal types 

Included in this section is an indication of whether the operands of 
the DFHTCT macro instruction are: 

1. Optional or required 

2. Applicable only to CICS/DOS, only to CICS/OS, or to both CICS/DOS 
and CICS/OS 

3. Applicable or required only under special circumstances 
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SPECIFY DATA SET CONTROL INFORMATION 








~~~ 
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DASD 


R 


R 
















































DISK 


R 


R 
















































SYS/3 




R 








R 





R 


























J 
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R 


R 








R 


R 





R 





Note: 



Required. 
Optional. 



* CICS/DOS only. 
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# CICS/OS only. 



DESCRIBE COMMUNICATION LINES 



TRMTYPE 
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O 


R 






R 


O 


R 


R 
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RO 
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R3 


O 


R 






R 
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R 


R 


O 


O 


R6 


R6 


O 














RO 
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R2 


O 
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RO 
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RO 
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RO 
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R 
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R 


R 


R 
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RO 
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RO 
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RO 
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R 


R 


R 


R 
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RO 
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RO 
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RO 


TAPE 


Ri 







R 


R 


R 
































RO 
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R 
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R 


R 
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R 
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Not e: R Required. 
O Optional. 



# CICS/OS only. 

* TRMMODL may be specified in TYPE=LINE or TYPE=TERMINAL. 

Required if a terminal work area (PCI) field is to be 
defined for all terminal entries associated with this line. 

1 Specify ACCMETH=SAM, ACCMETH=BSAM, or ACCMETH=SEQUENTIAL. 

2 Specify ACCMETH=BGAM or ACCMETH=GRAPHICS. 

3 Specify ACCMETH=BTAM or ACCMETH=TELECOMMUNICATION. 

4 Required for switched (dial-up) lines and multipoint lines. 

5 Required if FEATURE= (AUTOANSR, AUTOCALL, SCONTROL) . 

6 Required for first line in switched-line pool; specify 
ANSWRBK=EXIDVER for 3735 under CICS/OS and CICS/DOS-STANDARD 
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7 Checking required; other features optional. 

8 Required for component polling; default: poll all components, 

9 Required for the 2740 Model 2 or the 2740 with 2760. 



DESCRIBE TERMINAL TYPES 
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R 
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R 
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R3 




















R7 


1053 OS 


R 











Ri 





R2 











O 








R7 


1053 DOS 


R 











Ri 
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R7 
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R* 






















R7 


2020 


R 
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R* 






















R7 


2260 


R 
















R3 



















O 


R7 


L2260 


R 











R 

























R7 


2265 


R 
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R3 




















R7 


2740 


R 
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R3 




















R7 


2740/2760 


R 





R 










R3 











R 








R7 


2741C 


R 
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R7 


2741E 


R 




































R7 
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R* 



















O 


R7 


2780 


R 
















R* 






















R7 
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R 










R 
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R 
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R7 
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R 
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R7 
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R 
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R7 
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R7 
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R 
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R7 
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R 
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R7 
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R7 
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Note: R Required. 
Optional. 



1 Required only for local devices. 

2 Required only for remote devices; specify hexadecimal 
addressing characters. 

3 Required; specify hexadecimal addressing characters for 
non-switched lines; specify name of DFTRMLST for switched 
lines. (For TWX, not required if ANSWRBK=TERMINAL is 
specified) . 

4 Required for multipoint lines and for switched lines if 
FEATURE=AUTOCALL has been specified in the 

DFHTCT TYPE=LINE macro instruction; specify name of DFTRMLST. 

5 Required for component polling; defaults to polling all 
components. 
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6 Required for the 2740 Model 2 or the 27U0 with 2760. 

7 Required for terminals when the user defines a 0-255 

byte terminal work area (Process Control Information field) 
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APPENDIX E: FILE CONTROL TABLE CONFIGURATOR 



This section is intended to aid the system programmer in the 
preparation of the File Control Table (FCT) as he uses the DFHFCT 
TYPE=DATASET macro instruction to describe the physical characteristics 
of the data sets. These descriptions include information about the 
access method (BDAM or ISAM) and record characteristics for the data 
sets. 
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R 
























IOSIZE 
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SERVREQ=KEY 
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Note : R Required. 
Optional. 



Specifies relative type addressing; RELTYPE must also be 

specified. 

Required if main storage high-level index processing is 

used. 

Required if INDAREA is specified. 

Required only if a master index exists. 

Optional; used only if SERVREQ=NEWREC; for ISAM data sets 

under CICS/OS, IOWORK should also be specified. 

If SERVREQ=BROWSE or SERVREQ=NEWREC, this value must be 

BLKSIZE plus BLKKEYL. 

Required if key exists within logical records. 

Required if deblocking by key for BDAM (CICS/DOS and 

CICS/OS) ; required for variable-length ISAM records in 

fixed-length blocks (CICS/DOS only) . 
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APPENDIX F: CICS MACRO INSTRUCTIONS 



This section lists the CICS macro instructions used for system 
generation and table preparation. These macro instructions are written 
in Assembler language and, as all Assembler language instructions, are 
written in the following format: 

Name Operati o n Operands C omment s 

blank DFHxxxxx One or more operands 

or separated by commas 

symbol 

The name field of a CICS macro instruction must be left blank if 
the macro instruction is used in conjunction with a high-level language 
(ANS COBOL or PL/I); if a label is desired for the macro instruction, 
it may be placed on the card preceding the macro instruction. 

The operation field of a CICS macro instruction must begin before 
card column 16 and must contain the three-character combination "DFH" 
in the first three positions of the operation field. Up to five 
additional characters can be appended to DFH to complete the symbolic 
name for the appropriate program or table. Since DFH is reserved for 
CICS macro instructions, no other statement may begin with this 
three-character combination. 

The operand field of a CICS macro instruction contains one or more 
operands separated by commas. In this publication, parentheses are 
used to indicate those operands where more than one applicable parameter 
(keyword and otherwise) can be specified with a single use of the 
operand. Where parentheses are not used, only one parameter at a time 
can be specified as part of the operand; a choice must be made in the 
case of more than one applicable parameter. Since a blank character 
indicates the end of the operand field, the operand field must not 
contain blanks except after a comma on a continued card or after the 
last operand of the macro instruction. The first operand on a 
continuation card must begin in column 16. 

When a CICS macro instruction is coded on more than one card, each 
card containing part of the macro instruction (except the last card) 
must contain a character (for example, an asterisk) in column 72 
indicating that the macro instruction has been continued on the next 
card. 

In the following listing of CICS macro instructions, default 
parameters (where applicable) are indicated by an underscore. An 
asterisk in card column 72 indicates that the macro instruction is 
continued on the next card. 

Because the flexibility and modularity of CICS allows a wide 
combination of options during system generation and table preparation, 
no attempt is made in this section to indicate which operands are 
optional and which are mandatory. For this information, refer to the 
previous sections of this publication. 
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INITIALIZATION OF SYSTEM GENERATION 

DFHSG TYPE=INITIAL, * 

STATUS=FIRST r * 

ASMBLR=Asserabler name, * 

OPSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMECTL=YES,NO, * 

DSIZE=number,2, * 

MPS=YES,NO, * 

JOBNAME=jobname,CICS, * 

ACCTID=accounting information, CICSGEN, * 

PGMERID='programmer's name 1 ,' SYSTEM PRO GRA MMER 1 , * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CONDCD= ( (code, operator) , . . . , (code, operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=X,A, * 

CLASS=jobclass, A, * 

REGION= (n1K,n2K) , * 

PROCNMS=procedure names, (DFHASMV2,DFHLNKV2, * 

DFHUPDV2,DFHAUPLK) , * 

DL1=YES,N0, * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCTUA= (V1CMPAT, VARIllI;!) 

CONTROL SYSTEM OPERATIONAL GROUP (CSO) 

DFHSG PROGRAM=CSO, * 

MPS=YES,NO, * 

NSD=number,9, * 

DEVICE=231.1, 2314, 3330, * 

SVC=nuraber,200, * 

CAA=appendage suffix, * 

V1CMPAT=YES, * 
TCAMSIP=YES 

CONTROL SYSTEM SERVICE GROUP (CSS) 
DFHSG PROGRAM=CSS 

CONTROL SYSTEM DUMMY GROUP (CSD) 
DFHSG PROGRAM=CSD 

CONTROL SYSTEM UTILITY GROUP (CSU) 

DFHSG PROGRAM=CSU, * 
DEVICE= (TAPE, 2311,2314,3330) 

TASK CONTROL PROGRAM (KCP) 

DFHSG PROGRAM=KCP, * 

CONSEC=YES, * 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQUEUE=YES, * 

OPSECUR=YES, * 

ICPTIME=YES, * 
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ICPAUTO=YES r * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHR=symbolic name, * 
DEVICE= (2311,2314,3330) 

STORAGE CONTROL PROGRAM (SCP) 

DFHSG PROGRAM=SCP, * 

XTYPREQ=symbolic name, * 
SUFFIX=program suffix 

PROGRAM CONTROL PROGRAM (PCP) 

DFHSG PROGRAM=PCP, * 

PCPLOAD=YES,NO, * 

LANG= (COBOL, PL/I) , * 

HLLTR=YES,NO, * 

COBOL= (V2,V3,V4, SUBSET) , * 

XFETCH=symbolic name, * 
SUFFIX=prograra suffix 

PROGRAM INTERRUPT CONTROL PROGR AM (PIP) 

DFHSG PROGRAM=PIP, * 
SUFFIX=program suffix 

INTERVAL CONT ROL PROGRAM (ICP) 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XICEEXP=symbolic name, * 
DUMMY=YES 

DUMP CON TRO L PROGRAM (DCP) 

DFHSG PROGRAM=DCP, * 

DEVICE=TAPE, 2311, 2314, 3330, * 

DEVADDR=nnn, * 

CICSDMP=YES, * 

SUFFIX=program suffix, * 
DUMMY=YES 



TERMINAL CO NTR OL PROGRAM (TCP) 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM,BSAM,SAM,BGAM,TCAM) , * 

DEVICE^ (1403,14 04,1442,1443,1445,2311,2314,3330, * 

2501, 2520, 2540, CRLP,DASD, DISK, TAPE) , * 

BTAMDEV=(1030,1050,10 50D,1053,1130,1130D,20 20,2020D, * 

2260, L2260, 226 5, 2740, 2740D, 2740-2, 2741C, 274 1E, * 

274 1DC, 2741 DE, 2760, 2770, 277 0D, 2780, 2780D, * 

2980/1, 2980/2, 2980/4, 3275, 3277, L3277, 3284, * 
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L32 84, 3 286 , 13286,37 3 5D f 7770, SYS/3, S YS/3D , SYS/7, * 

SYS/7D,S/360,S/360D,S/370,S/370D,TWX,BISYNC) , * 

FEATURE=(AUTOANSW,AUTOPOLL,BUFFRECV,PSEUDOEIN) , * 
ANSWRBK=(EXIDVER, TERMINAL, AUTOMATIC, 7770TERM,7770NULL) , * 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSCODE= (EBCDIC,ASCII,TRANSCODE) , * 

AUTCTRN=YES, ~ * 

UCTRAN=NO, (EBCDIC, ASCII) , * 

CCMPAT=NO, (FORMAT, FULLBUF) , * 

FMT2260=(6X40, 12X40, 12X80, 15X64) , * 

FMT3270=(J2X40, 24X80) , * 

CMPT60L=(n1,n2,n3) , * 

SMI=user character, j£, * 

TAB=YES,NO, * 

CCNVTAE=(ABB,ABC) , * 

XATTACH=symbolic name, * 

XOOTPDT=symbolic name, * 

XINPUT=symbclic name, * 

XTCMIN=symbolic name, * 

XTCMOUT=symbolic name, * 

TCM3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SDFFIX=program suffix 

1ILM CONTJOL PROGRAM (FCP) 

DFHSG PROGRAM=FCP, * 

CONSEC=YES, * 

FILSERV= (INEA,INIS,EAUPD,ISUPD,EAADD,ISADD,INDIRACC, * 

EXCTL,INSEG,OUTSEG,EABLKNG,VLR,HEXAD,EECAD, * 

ACTAE,IVBR, LOCATE, IB BOWSE ,DBROWSE) , * 

SUFFIX=Fiograra suffix, * 

XTYPREQ=symbolic name, * 

XOUTPDT=symbclic name, * 

XINPUT=symbolic name, * 

XINPDTC=symbolic name, * 
DUMMY=YES 

1MNSIENT DATA CCNTRCL PROGRAM (TDP) 

DFHSG PROGRAM=TDP, * 

INTRA=YES,TRANSINIT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SUFFIX=program suffix, * 

DEVICE=2311., 2314, 3330, * 

XTYPEEQ=symbclic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 

TEMPORARY STORAGE CCNTRCL PROGRAM (TSP) 

DFHSG PROGRAM=TSP, * 

DEVICE=2311, 2314, 3330, * 

VIRTUAL= (VIRTUAL, REAI) , * 

SUFFIX=program suffix, * 

XTYPEEQ=syrabolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=syrabolic name, * 
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DUMMY=YES 

COMMON SYSTEM AREA (CSA) 

DFHSG PROGRAM=CSA, * 

WRKARFA=number, 5J12, * 

SUEEIX=program suffix 

MASTER TERMINAL PROGRAM (MTP) 

DFHSG PROGRAM=MTF, * 

TLT=YES,NO 

DYNAMIC CPEN/CLOSE PROGRAM (OCP) 
DFHSG PROGRAM=OCP 

GRAP HIC ATTENTION PROGRAM (GAP) 
DFHSG PROGRAM=GAP 

HIGH-LEVEL LANGUAGE SUPPORT GROUP (HLL) 

DFHSG PROGRAM=HLL, * 

LANG= (CCBOL r EL/I) , * 

PL1=(0,F) 

TERMINAL DEPENDENT CONTROL PROGRAM (TDCP) 
DFHSG PROGRAM=DDM 

A SYNCHRO NODS TRANSACTION PROCESSING GROUP (ATP) 

DFHSG PROGRAM=ATP, * 

INBUFF=nuraber f * 

OUTEUFF=number 

TERMINATION OF CICS/DOS SYSTEM GENERATION 
DFHSG TYPE=FIHAL 
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SYSTEM INITIALIZ ATIO N TABLE (SIT) 

DFHSIT TYPE=CSECT,DSECT, * 

SUFFIX=XX f * 

TRT=deciraal value, 0, * 

SCS=decimal value, 500, * 

SP1=decimal value, 0, * 

DVT=2311, 2314, 3330, * 

MSGLVL=0,1., * 

TSBLK=deciraal value, 3625, * 

ICV=decimal value, .1000, * 

ICVS=decimal value, 20000, * 

ICVE=decimal value, 5000, * 

CDL=decimal value, 5, * 

MXT=decimal value, 5, * 

TCT=xx, * 

PPT=xx, * 

PCT=xx, * 

FCT=xx,NO, * 

DCT=xx,N0, * 

CSA=xx, * 

KCP=XX, * 

SCP=xx, * 

PCP=xx, * 

DCP=xx f NO, * 

ICP=xx,N0, * 

TCP=xx, * 

FCP=xx, * 

TDP=xx, * 

TRP=xx,NO, * 

PIP=xx,N0, * 

TSP=xx,NO, * 

OSCOR=decimal value, 0, * 

PL1=YES,N0, * 

DL1=YES,NO, * 

PSB=name,CICSPSB, * 

PSBPL=number,4,~ * 

DMBPL=number,4, * 

BUFPL=number,8, * 

ATP=YES,N0, * 

ATPMT=number,J[ * 

ATPMB=number,MXT speci fica t io n mi nus one, * 
SIM0DS= (A2,BJ,C1,C2,C3,DJ[,E1 > ) or " 

(A2,bji,cT,dT,ej.) 
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TERMINAL CONTROL TABLE (TCT) 

DFHTCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSnnn, * 

DEVICE=1 30, 1050, 1130, 1403 ,140 4, 1442,1443, 1445, * 

2020, 2260, L2260, 226 5, 231 1,23 14, 2501, 2520, * 

2540, 2740, 2740/2760, 274 1C, 274 1E, 2770, 2780, * 

29 80, 3275, 3277, L3277, 3284, L3284, 3286, L3286, * 

3330,3735,7770, BSCMDMPT, BSCMDPPT,BSCMDSW,DASD, * 

DISK,SYS/3,SYS/7,S3 60,TAPE,TW33,TW35,TCAM, * 

DSCNAME=name, * 

ERROPT=E,R,W,C,N,RW,T, * 

FEATURE=(STC,CHK,BSC,KBL,OIU,SIX,SXW,SIW,RIX, * 

RXW,RIW,MAS,SLV,APL) , * 

LINELST=(nnn1,...,nnn31) , * 

SWITCH=YES,NO, * 

CU=2701, 2702, 2703, 2848,3272, * 

CONFIG=PPT,MPT, * 

BSCODE=EJCDI£, ASCII, TRANSCODE, * 

MODELST= (n1,. . .,n31) , * 

RETRY=number,7, * 

TERMTST=YES,NO, * 

LERBADR=symbolic address, * 

DDNAME=name, defaults to DSCNAME, * 

MACRF= (R,W) , * 

FLNNAME=name, * 

NCP=nuraber,J[, * 

MODE=(,CNTRL,A or B,A or B) , * 

BLKSIZE=length, "" * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=W,WU,WC,WUC, * 
APPENDG=appendage suffix 

symbol DFHTCT TYPE=LINE, * 

ACCMETH=SAM,BSAH,BTAM,BGAM,TCAM, SEQUENTIAL, GRAPHIC, * 

TELECOMMUNICATION, * 

TRMTYPE=1030,1050,1053,1130,20 20,226 0,L2260,2265, * 

2740, 2740/2760, 274 1C, 2 741 E, 2770, 2780, 29 80, * 
3 275,3 277,L3277,32 84,L3284,3286,L3286,3735,777 0, * 

SYS/3, SYS/7, S360,CRLP,DASD,T APE, TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY,BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number or character, * 

BTAMRLN=number, * 

LISTADR= (name, WRAP) , * 

FEATURE= (AUTOANSR, AUTOCALL, AUTOPOLL, CHECKING, * 

SCONTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

POOLADR=symbolic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL, EXIDVER, * 

LINSTAT=»OUT OF SERVICE 1 , * 

B S CO DE= EBCDIC, ASCII, TRANSCODE, * 

CONVTAB=EBCDIC, ASCII, TRANSCODE ,TEXTMODE, ABB, ABC, * 

RDYMSG=symbolic address, * 

ERRMSG=symbolic address, * 

GENPOLL=YES, * 

POOLCNT=number , * 

TCTUAL=number,0, * 
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OUTQ=symbolic name, * 

POOL=YES, * 
QUEUEID=hexadecimal number 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number,0, * 

TRMMODL=number, character , * 

TRHTYPE=1 030 ,1050,1053,113 0,2020,2260,12260 ,226 5, * 

2740, 2740/2760, 274 1C, 2741 E, 2770, 2780, 2980, * 

3 275,3277,L3277,32 84,L3284,3286,L3286,3735,7770, * 

SYS/3,SYS/7,S3 60,CRLP,DASD,TAPE,TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY, BISYN C, AUDIO) , * 

LVUNIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address,name, * 

TRHSTAT= (TRANS ACTION, TRANSCEIVE, RECEIVE, 'OUT OF SERVICE 1 ,* 

INPUT) , * 

COHPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT, SELCTPEN , AUDALARM ,COPY , BUFEXP, * 

UCTRAN,DCKYBD) , * 

POLLPOS=number , * 

TRANSID=narae, * 

STN2980=number, * 

TAB2980=number,0, * 

TIOAL=number, * 

TCTUAL=number 

symbol DFHTCT TYPE=7770MSG, * 
MESSAGE=' message 1 

DFHTCT TYPE=FINAL 



FILE CON TRO L TABLE (FCT) 

DFHFCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM,ISAM,DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NEWREC,INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSIZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 

NRECDS=number, * 

IOSIZE=number, * 

IOWORK=symbolic name, * 

DEVICE= (n,m) , (2314,2314) , * 

SRCHM=YES, number, "" * 

VERIFY=YES, * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM=(f or mat, characteristic, DCB record format), * 

OPEN- INITI AL, DEFERRED, * 
KEYLEN=length 
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DFHFCT TYPE=INDACC, 
OBJDSID=name, 
IARLKP=number, 
IALKFL=length, 
IADADMI=RELREC,KEY, 
IADIII=hexadecimal character, 
DUPDSID=name 



DFHFCT TYPE=SEGHEAD, 

SEGLENG=length, 
INDDISP=number, 
TSEGIND=BIT, DISPLACEMENT 

DFHFCT TYPE=SEGDEF r 
SEGNAME=narae, 

SEGCHAR= (format, alignment) , 
SEGLENG=length 

DFHFCT TYPE=SEGSET, 
SEGSET=name, 
SEGNAME= (namel ,. . . ,nameN) 

DFHFCT TYPE=SEGLAST 

DFHFCT TYPE=FINAL 

DFHFCT TYPE=LOGICMOD 



DES TINATI ON CONTROL TABLE (DCT) 

DFHDCT TYPE=INITIAL, 
SUFFIX=xx, 
TRNSUFX=(XX,.. .) , 
SEPASMB=YES,NO 

DFHDCT TYPE=SDSCI, 

DSCNAME=name, 

MODNAME=name, 

DEVICE=1403, 1404, 1443, 1445, 231 1,231 4, 333 0, TAPE, 

BLKSIZE=length, 

DEVADDR=symbolic address, 

RECFORM=FIXONB,FIXBLK,VARONB,VARBLK, UNDEFINED, 

FILABL=STD,NO, 

TYPEFLE=INPUT, OUTPUT, RDBACK, 

RECSIZE=length, 

REWIND=UNLOAD, NORWD, LEAVE, REREAD, 

TPMARK=NO, 

BUFNO=number,1., 

ERROPT=SKIP, IGNORE, 

SUFFIX=xx 



DFHDCT TYPE=EXTRA, 

DSCNAME=name, 
DESTID=name, 
OPEN=INITIAL, DEFERRED, 
RESIDNT=YES,NO 

DFHDCT TYPE=INTRA, 
DESTID=name, 
REUSE=YES,NO, 
TRIGLEV=number, 
DESTFAC=TERMINAL,FILE r 
TRANSID=name 
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DFHDCT TYPE=INDIRECT f * 

DESTID=name, * 

INDDEST=name 

DFHDCT TYPE=FINAL 

PROGRAM CONTROL TABLE (PCT) 

DFHPCT TYPE=INITIAL, * 

SUFFIX=XX 

DFHPCT TYPE=ENTRY, * 

TRANSID=name, * 

TRNPRTY=decimal value, 001, * 

TRANSEC=decimal value, 001, * 

TWASIZE=decimal value, 0, * 

PROGRAM=name, * 

TPURGE=YES,NO, * 

SPURGE=YES,NO, * 
COMPAT=NO,FORMAT,FULLBUF 

DFHPCT TYPE=FINAL 



PROCESSING PROGRAM TABLE (PPT) 

DFHPPT TYPE=INITIAL, * 

SUFFIX=XX 

DFHPPT TYPE=ENTRY, * 

PROGRAM=name, * 

P G ML A NG= ASSEMBLER, COBOL, PL/I, * 

RES=YES,NO, ~ * 
RSLOAD=YES,NO 

DFHPPT TYPE=FINAL 

SIGN- ON TABLE (SNT) 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME=» operator name', * 

PASSWRD=password, * 

OPIDENT=operator identification, * 

SCTYKEY=security key,J[, * 
OPPRTY=operator priority, 

DFHSNT TYPE=FINAL 

TERMINAL LIST TABLES (TLT) 

DFHTLT TYPE=INITIAL, * 

SUFFIX=XX 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=terminal identification 

DFHTLT TYPE=FINAL 
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DYNAMIC OPE N/CLO SE MACRO INSTRUCTIONS 

DFHOC TYPE=OPEN, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=syrabolic address, * 

DSETID= (name, (xx) ,. ..) , * 
CHECK=symbolic address 

DFHOC TYPE=CLOSE, * 

DATASET=TRANSD ATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES , * 

SYMBADR=symbolic address, * 

DSETID= (name,. . .) , * 
CHECK=symbolic address 

DFHOC TYPE=SWITCH, * 
DATASET=DUHP 
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APPENDIX G: EXAMPLES OF USER-WRITTEN TRANSACTIONS 



This section contains examples of user-written transactions. The 
source coding is written in Assembler language. 

EXAMPLE OF A J030 TRANSACTION 

The following example of a 1030 transaction: 

1. Analyzes the terminal transaction code in the first byte of 
data. 

2. Matches the transaction code with the entry in the Program 
Control Table (PCT) for the desired transaction. 

3. Issues a Program Control XCTL macro instruction for the program 
name found in the table search. 

Note: The 1030 transaction must take into account the size of the 
largest Transaction Work Area (TWA) needed by the program to 
which control is to be transferred. 





COPY 


DFHCSADS 




COPY 


DFHTCADS 


TCTTEAR 


EQU 


7 




COPY 


DFHTCTTE 


TIOABAR 


EQU 


6 




COPY 


DFHTIOA 


PCTCBAR 


EQU 


5 




COPY 


DFHPCTDS 


TRAN1030 


CSECT 






ENTRY 


T1030 


T1030 


EQU 


* 




BALR 


2,0 




USING 


*,2 




L 


TCTTEAR, TCAFCAAA 




L 


TIOABAR, TCTTEDA 




L 


PCTCBAR, CSAPCTBA 




MVC 


TIOADBA(80) ,TIOADBA+1 


PCTLOOP 


EQU 


* 




CLC 


PCTTI,TIOADBA 




BE 


TRANCTL 




LA 


PCTCBAR, PCTEA 




CLI 


PCTTI,X , FF' 




BNE 


PCTLOOP 


END 


EQU 


* 




DFHPC 


TYPE=RETURN 


TRANCTL 


EQU 


* 




MVC 


TCAPCPI,PCTIPIA 




DFHPC 


TYPE=XCTL 




END 


T1030 



COPY CSA SYMBOLIC STRG DEFN 
COPY TCA SYMBOLIC STRG DEFN 
TERM CONTROL TABLE ADDRESS REG 
COPY TCT SYMBOLIC STRG DEFN 
TERMINAL I/O AREA ADDRESS REG 
COPY TIOA SYMBOLIC STRG DEFN 
PROG CONTROL TABLE ADDRESS REG 
COPY PCT SYMBOLIC STRG DEFN 
CONTROL SECTION - 1030 INPUT ED 
1030 INPUT EDIT ENTRY ADDRESS 
1030 INPUT EDIT ENTRY ADDRESS 
ESTABLISH BASE ADDRESS REGISTER 
USING REGISTER 2 FOR BASE REG 
LOAD FACILITY CONTROL ADDRESS 
LOAD TERMINAL I/O AREA ADDRESS 
LOAD PROGRAM CONTROL TABLE ADDR 
SHIFT INPUT DATA ONE BYTE 
PROGRAM CTL TABLE SEARCH ENTRY 
COMPARE TRANSACTION IDENT 
GO TO TRANSFER CONTROL IF EQUAL 
ADVANCE TO NEXT TABLE ENTRY 
TEST FOR END OF TABLE 
CONTINUE SEARCH IF NOT EQUAL 
END OF TABLE SEARCH ENTRY 
PROGRAM CONTROL RETURN 
TRANSFER CONTROL ENTRY 
MOVE PROGRAM NAME TO TCA 
PROGRAM CONTROL TRANSFER CONTROL 



EXAMPLE OF A 2760 TRANSACTION 

The following example of a 2760 transaction: 

1. Analyzes input data that CICS has translated to EBCDIC 
representation. 
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2. Changes index numbers (11, 12) to frame numbers. 

3. Converts horizontal/vertical coordinates received from the 2760 
to points ranging from 1 to 252. These points represent screen 
positions arranged (top to bottom, left to right) on a screen 
of 21 vertical columns and 12 horizontal rows. 

4. Indicates how to detect reserved points on the screen, some of 
which are built into the hardware and some of which are assigned 
by the user. 

5. Shows a procedure for generating the necessary control (function) 
information and Move Amount Character codes so that CICS can 
transmit output data to the 2760. Before output transmission 

to the 2760 occurs, CICS translates the data to 2740 code. 





COPY 


DFHCSADS 




COPY 


DFHTCADS 


TCTTEAR 


EQU 


7 




COPY 


DFHTCTTE 


TIOABAR 


EQU 


6 




COPY 


DFHTIOA 


PCTCBAR 


EQU 


5 




COPY 


DFHPCTDS 


REG8 


EQU 


8 


REG9 


EQU 


9 


REG10 


EQU 


10 


REG15 


EQU 


15 


TRAN2760 


CSECT 






ENTRY 


T2760 


T2760 


EQU 


* 




BALR 


2,0 




USING 


*r2 




L 


TCTTEAR, TCAFCAAA 




L 


TIOABAR, TCTTEDA 




L 


PCTCBAR, CSAPCTBA 




BAL 


REG10,COMPIHV 




CLI 


POINTNO+1 ,132 




BE 


FORWARD1 




CLI 


POINTNO+1, 144 




BE 


F0RWARD2 




CLI 


POINTNO+1, 156 




BE 


FORWARD3 




CLI 


POINTNO+1, 168 




BE 


F0RWARD4 




CLI 


POINTNO+1, 180 




BE 


FORWARD5 




CLI 


POINTNO+1, 240 




BE 


REVERSE1 




CLI 


POINTNO+1, 228 




BE 


REVERSE2 




CLI 


POINTNO+1, 216 




BE 


REVERSE3 




CLI 


POINTNO+1, 204 




BE 


REVERSE4 




CLI 


POINTNO+1, 192 




BE 


REVERSE5 




CLI 


POINTNO+1, 245 




BE 


UNLOAD 




CLI 


POINTNO+1, 246 




BE 


LOAD 




B 


END 


FORWARD1 


EQU 


* 




MVI 


FUNCTION, X«F1 » 



COPY CSA SYMBOLIC STRG DEFN 
COPY TCA SYMBOLIC STRG DEFN 
TERM CONTROL TABLE ADDRESS REG 
COPY TCT SYMBOLIC STRG DEFN 
TERMINAL I/O AREA ADDRESS REG 
COPY TIOA SYMBOLIC STRG DEFN 
PROG CONTROL TABLE ADDRESS REG 
COPY PCT SYMBOLIC STRG DEFN 
REGISTER EIGHT 
PEGISTER NINE 
REGISTER TEN 
REGISTER FIFTEEN 

CONTROL SECTION - 2760 INPUT ED 
2760 INPUT EDIT ENTRY ADDRESS 
2760 INPUT EDIT ENTRY ADDRESS 
ESTABLISH BASE ADDRESS REGISTER 
USING REGISTER 2 FOR BASE REG 
LOAD FACILITY CONTROL ADDRESS 
LOAD TERMINAL I/O AREA ADDRESS 
LOAD PROGRAM CONTROL TABLE ADDR 
LINK TO COMPUTE 11, 12, H, & V 
FORWARD ONE 

FORWARD TWO 

FORWARD THREE 

FORWARD FOUR 

FORWARD FIVE 

REVERSE ONE 

REVERSE TWO 

REVERSE THREE 

REVERSE FOUR 

REVERSE FIVE 

UNLOAD 

LOAD 



FORWARD, AUTO EOM, MFA DISABLED 
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MVC 


ADVANCE, =H' 1' 




B 


WR2760 


F0RWARD2 


EQU 


* 




MVI 


FUNCTION, X'F1 ' 




MVC 


ADVANCE, =H»2' 




B 


WR2760 


F0RWARD3 


EQU 


* 




MVI 


FUNCTION, X»F1« 




MVC 


ADVANCE, =H'3' 




B 


WR2760 


FORWARDS 


EQU 


* 




MVI 


FUNCTION, X»F1 ■ 




MVC 


ADVANCE, =H»4» 




B 


WR2760 


FORWARD5 


EQU 


* 




MVI 


FUNCTION, X'FV 




MVC 


ADVANCE, =H'5« 




B 


WR2760 


REVERSE1 


EQU 


* 




MVI 


FUNCTION, X^UO 1 




MVC 


ADVANCE, = H» 1» 




B 


WR2760 


REVERSE2 


EQU 


* 




MVI 


FUNCTION, X'aO' 




MVC 


ADVANCE, =H«2» 




B 


WR2760 


REVERSE3 


EQU 


* 




MVI 


FUNCTION, X«40» 




MVC 


ADVANCE, =H , 3» 




B 


WR2760 


REVERSED 


EQU 


* 




MVI 


FUNCTION, X'40' 




MVC 


ADVANCE, = H'4« 




B 


WR2760 


REVERSE5 


EQU 


* 




MVI 


FUNCTION, X'40' 




MVC 


ADVANCE, =H'5» 




B 


WR2760 


LOAD 


EQU 


* 




MVI 


FUNCTION, X«F1 • 




MVC 


ADVANCE, =H , 8» 




B 


WR2760 


UNLOAD 


EQU 


* 




MVI 


FUNCTION, X« 40« 




MVC 


ADVANCE, =H*255» 


WR2760 


EQU 


* 




LA 


REG9,3 




STH 


REG9,TIOATDL 




MVC 


TIOADBA(1) , FUNCTION 




BAL 


REG10,COMPADV 




MVC 


TIOADBA+1 (2) , ADVANCE 




DFHTC 


TYPE= (WRITE, OIU) 




B 


END 


END 


EQU 


* 




DFHPC 


TYPE=RETURN 


COMPIHV 


EQU 


* 




TR 


TIOADBA+2<2) ,TRTBL 




SR 


REG9,REG9 




IC 


REG9,TIOADBA+2 




SLL 


REG9,5 




SR 


REG8,REG8 




IC 


REG8,TIOADBA+3 




AR 


REG8,REG9 




STH 


REG8,FRAMENO 




TR 


TIOADBA+4 (2) ,TRTBL 



FORWARD ONE FRAME 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD TWO FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD THREE FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD FOUR FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD FIVE FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE ONE FRAME 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE TWO FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE THREE FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE FOUR FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE FIVE FRAMES 

LOAD 

FORWARD, AUTO EOM, MFA DISABLED 

FORWARD EIGHT FRAMES 

UNLOAD 

REVERSE, AUTO EOM, MFA DISABLED 

REVERSE 255 FRAMES 



LINK TO COMPUTE FRAME ADVANCE 



END OF TABLE SEARCH ENTRY 
PROGRAM CONTROL RETURN 
COMPUTE 11, 12, HORIZ, AND VERT 
TRANSLATE 2 CHARS 11 AND 12 
CLEAR REGISTER NINE 
PLACE 11 IN REGISTER NINE 
MULTIPLY 11 BY 32 
CLEAR REGISTER EIGHT 
PLACE 12 IN REGISTER EIGHT 
SUM OF 11X32 AND 12 IN REG 8 
STORE 2760 FRAME NUMBER 
TRANSLATE 2 CHARS VERT & HORIZ 
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FRAMENO 
POINTNO 
TRTBL 



COMPADV 



FUNCTION 

ADVANCE 

LCXTRTBL 



SB 

IC 

MH 

LR 

SR 

IC 

AR 

LA 

SR 

STH 

BR 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DS 

LH 

SR 

LA 

DR 

STC 

STC 

TR 

BR 

DC 

DS 

DC 

DC 

END 



REG8,REG8 

REG8,TIOADBA+5 

REG8,=H« 12« 

REG9,REG8 

REG8,REG8 

REG8,TIOADBA+4 

REG9,REG8 

REG8,255 

REG8,REG9 

REG8, POINTNO 

REG10 

H'O' 

H'O' 

X« 

X' 

X' 

X* 

x« 

X' 

X' 

X' 

X' 

X' 

X' 

X 1 

X' 

X* 

X' 

X' 

OH 

REG9, ADVANCE 

REG8,REG8 

REG15,32 

REG8, REG15 

REG9, ADVANCE 



CLEAR REGISTER EIGHT 
PLACE HORIZONTAL IN REGISTER 8 
MULTIPLY HORIZONTAL BY TWELVE 
12H RESULT IN REGISTER NINE 
CLEAR REGISTER EIGHT 
PLACE VERTICAL IN REGISTER 8 
12H + V RESULT IN REGISTER NINE 
LOAD 255 IN REGISTER EIGHT 
255-12H-V RESULT IN REGISTER 8 
STORE 2760 POINT NUMBER 
COMPUTE 11, I2 f H, AND V EXIT 
2760 FRAME NUMBER 
2760 POINT NUMBER 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 

OOFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' 

03FFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 

020 5FFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 

FFFrFFFFFFFFFFFFFFFFFFFFOIFFFFFF 1 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' 

FF070B0F13171B1FFFFFFFFFFFFFFFFF' 

FF060A0E12161A1EFFFFFFFFFFFFFFFF 1 

FFFF090D1115191DFFFFFFFFFFFFFFFF 1 

FF04080C1014181CFFFFFFFFFFFFFFFF' 

COMPUTE MANUAL FRAME ADVANCE 

LOAD 2760 MANUAL FRAME ADVANCE 

CLEAR REGISTER EIGHT 

LOAD DIVISOR OF 32 

DIVIDE FRAME ADVANCE BY 32 

STORE SECOND BYTE OF ADVANCE 

STORE FIRST BYTE OF ADVANCE 

TRANSLATE MANUAL FRAME ADVANCE 

COMPUTE FRAME ADVANCE EXIT 

2760 FUNCTION 

2760 MANUAL FRAME ADVANCE 



REG8,ADVANCE+1 

ADVANCE (2) , LCXTRTBL 

REG10 

X»00' 

H'O' 

X'407C6050F1619181F2A29282F3A39383» 

X'F4A49484F5A5958 5F6A69686F7A79787» 

T2760 



MM-EIil 91 A 3735 TRANSACTION (Not applicable to CICS/DOS-ENTRY) 
The following example of a 3735 transaction: 

1. Reads data from the 3735 and spools to an extrapartition data 
set. 

2. Upon receipt of the end-of-file condition, writes an FDP header 
record, FDP records, an FDP trailer record, and data. 

3. Sends a powerdown message. 

4. Disconnects the line. 



COPY DFHCSADS 

COPY DFHTCADS 

COPY DFHTCTTE 

COPY DFHTIOA 

COPY DFHTDIA 



COMMON SYSTEM AREA DSECT 
TASK CONTROL AREA DSECT 
TERMINAL CONT TABLE DSECT 
TERMINAL I/O AREA DSECT 
TRANSIENT DATA I/O AREA DSECT 
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TCTTEAR 
TIOAEAR 
TDIAEAR 
EASEREG 
WORKREG 



RLCOP 



HEADER 



WLCOFF 



TRAILER 



WLCCPD 



FINISH 



FORTY 

BIKLGTH 

HREC 



'REC 



FWRDWN 



EQU 

EQU 

EQU 

EQU 

EQU 

CSECT 

BALR 

USING 

L 

L 

DFHTC 

EQU 

DFHTD 



DFHTC 

L 

B 

EQU 

L 

HVC 

ST 

DFHTC 

EQU 

CFHTD 



L 

MVC 

MVC 

MVC 

ST 

DFHTC 

B 

EQU 

HVC 

ST 

DFHTC 

EQU 

DFHTD 



L 

HVC 

HVC 

HVC 

ST 

DFHTC 

E 

EQU 

HVC 

DFHTC 

DFHTC 

DFHPC 

EC 

DC 

DC 

DC 

EC 

EC 

DC 

DC 

DC 

EC 



BASEREG, 

*, EASEREG 

TCTTEAR,TCAFCAAA 

TIOAEAR,TCTTEEA 

EOF=HEADER 

TYPE=PUT, 

DESTID=OUTQ, 

TEADDR=TIOAEBA 

TYPE=GET, 

ECF=HEADER 

TIOAEAR, TCTTEDA 

RLOOP 

TIOAEAR, TCTTEDA 
TIOATDL(7) , HREC 
TIOABAR, TCTTEDA 
TYPE= (PUT, SAVE) 

TYPE=GET, 
DESTID=FDPQ, 
QUEZEEO=TRAILER 
TDIABAR, TCATDAA 
TIOADBA (240) ,0 (TDIA 
TIOADBA+240 (236) ,24 
TIOATEL, BIKLGTH 
TIOAEARRTCTTEDA 
TYPE= (PUT, SAVE, NOTR 
WLCOPF 

TIOATDL (7) ,TREC 
TICAEAR,TCTTEDA 
TYPE= (PUT,SAVE) 

TYPE=GET, 
DESTTD=DATQ, 
QUEZERO=FINISH 
TEIABAR, TCATDAA 
TIOADBA (240) ,0 (TDIA 
TIOADBA + 240 (236) ,24 
TIOATDL, BLKLGTH 
TIOAEAR, TCTTEEA 
TYPE= (PUT, SAVE) 
WLCOPD 
* 

TIOATDL (7) ,PWRDWN 

TYPE=PUT 

TYPE=DISC 

TYPE=RETURN 



TCTTE BASE REGISTER 
TIOA BASE REGISTER 
TDIA BASE REGISTER 
PROGRAM BASE REGISTER 
WORK REGISTER 

LOAD PROGRAM BASE REGISTER 



ADDRE 
ADERE 
TEST 
BATCH 
WRITE 
TO OU 
DATA 
READ 
AND T 
AEDRE 
LOOP 
WRITE 
ADDRE 
MOVE 
SPECI 
WRITE 
BATCH 
GET F 
FROM 
SEND 
ADDRE 
EAR) MOVE 
(TDIABAR) 
SET L 
SPECI 
ANSLATE) 

LOOP 
WRITE 
MOVE 
SPECI 
WRITE 
BATCH 
GET D 
FROM 
EXIT 
ADDRE 
BAR) MOVE 
(TDIABAR) 
SET L 
SPECI 
WRITE 
LOOP 
END U 
MOVE 
SEND 
DISCO 
EXIT 



SSABILITY TO TERM CONT TBL 
SSABILITY TO TERH I/O AREA 
FOR END-OF-FIIE CONDITION 

READ LOOP 

DATA RECORD * 

TPUT QUEUE * 

IS IN TIOA 

NEXT RECORD * 

EST FOR END-OF-FILE 
SSABILITY TO TIOA 

FDP HEADER RECORD 
SSABILITY TO TIOA 
HEADER RECORD TO TIOA 
FY TIOA ADDRESS 

TO 3735, SAVE TIOA 

FDP WRITE LCOP 
DP RECORD * 

FDP QUEUE * 

TRAILER WHEN DONE 
SSABILITY TO DATA 
DATA 

TO TIOA 
ENGTH FOR WRITE 
FY TIOA ADDRESS 
WRITE TO 3735 

FDP TRAILER RECORD 
TRAILER RECORD TO TIOA 
FY TIOA ADDRESS 

TO 3735, SAVE TIOA 

DATA WRITE LOOP 
ATA * 

DATA QUEUE * 

WHEN DONE 
SSABILITY TO DATA 
DATA 

TO TIOA 
ENGTH FOR WRITE 
FY TIOA ADDRESS 

TO 3735, SAVE TIOA 



POWER DOWN HESSAGE TO TIOA 
POWER DOWN HESSAGE 
NNECT LINE REQUEST 



40' 
476' 
3» 
t 

GCC600' 

3' 
t 

00C50O* 
3' 
i 



NUIL F NULL 



NULL E NULL 
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EC X'OODTOO 1 POWER DOWN MESSAGE 

LTOBG 

END 
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INDEX. 

This index has been prepared by an automated 

indexing program. Your comments and suggestions 

will be appreciated. 

The intent is to list primary pago 

references first. 



AACA 169 

ABB 32,37, 181- 183, 15, 50,62,68, 203, 206 

ABB CODE 68 

ABB SPECIFIES CONVERSION 36 

ABB TRANSMISSION CODE 36 

ABC 32,37, 15, 5«, 62, 68, 203,206 

ABC CODE 68 

ABC SPECIFIES CONVERSION 36 

ABC TRANSMISSION CODE 36 

ABEND 173-174,129,146, 192 

ABEND CODE 169,171 

ABEND CODE INDICATES 169 

ABEND TASK 128 

ABNORMAL CONDITION INVALID ERROR CODE 169 

ABNORMAL CONDITION LINE ENTRY 

DIAGRAM OF THE TERMINAL 123 
ABNORMAL CONDITION PROGRAM 23,162,177,176 
ABNORMAL TERMINATION COMPLETE DATE 156 
ABORT 173-171 

ABORT TERMINAL WRITE REQUESTS 126 
ACB'S «6 

ACCESS 88,113,120-121,1,9,99,114 
ACCESS DL/I 

ACCESS METHOD 6,32,63,82,199 
ACCESSED UNDER CICS/OS 82 
ACCMETH 82-81, 32-33, 37,196,24, 62- 63, 66, 182- 183 

191,79-80,189,15,54,81,92,179-181,181-185 
186-189,202,206-207 
ACCTID 19-20,14,201 
ACQUISITION 39,15,203 
ACQUISITION INDICATES INPUT 40 
ACTAD 38,15,203 
ACTION 140-143,124,153,171 
ACTION QUEUE PURGE DYNAMIC OPEN/CLOSE 17 
ACTION SET 121-122 
ACTIVE CICS TRANSACTION 

MODE OF THE 172 
ACTIVE TASKS SINCE NO TCTTE 145 
ACTUAL DESTINATION 
ADD 91 
ADD DA.1 6 38 
ADD ISAM 7 

ADDITIONAL ISAM LOGIC MODULE 91 
ADDITIONAL SENSEG STATEMENT 45 
ADDITIONAL SYSTEM INITIALIZATION MODULES 50 
ADDR 192-193 
ADDRESS 

ERROR BYTE PLUS THREE-BYTE 160 

SYMBOLIC 54,206,62,95-96,159,210,56,68,94,159,161 

SYMBOLIC 208 
ADDRESS DFHOC TYPE 

SYMBOLIC 159,210 
ADDRESSABILITY 215,118,128 

ADMINISTRATIVE TERMINAL FACILITIES DESCRIBED 152 
AICA 169 
AKCA 169 

ALIGNMENT 89-90,81,208 

ALTERNATE DUMP DATA SET 11-12,162,153 
ALTERNATE STATION ADDRESS 75-76 
AMERICAN STANDARD CODE 59,68 
ANALYSIS DFHTDP 119 
ANS COBOL 1,28,200 
ANS COBOL VERSION 2 COMPILER 28 
ANS COBOL VERSION 3 COMPILER 28 
ANS COBOL VERSION 1 COMPILER 28 
ANSWRBK 32-31,57,59,62,66,73,137,181-183,67-68 

15,54,80,184,186-188,197,203,206 
APAR NO. P10780 21,41 
APCI 170 
APIA 170 
APL 56,58,54,206 

APPENDAGE SUFFIX SYMBOL DFHTCT TYPE 54,206 
APPENDAGE 7770 SVC 

APPENDAGE END 18 
APPENDG 56,61,54,181,206 
APPENDG OPERAND 21 
APPENDIX 93,97-99,106-107,110 

NONE 71 175 
APPENDIX B 77-78,179 
APPENDIX C 190 
APPENDIX E 199 
APPENDIX F 200 
APPENDIX G 75 
APPLICATION INPUT 

DISCUSSION OF THE OPTCD OPERAND OF THE 113 
APPLICATION PROGRAM 138,171-173,19,22,130,35,43,87, 
133,135,139,142 

USER-WRITTEN 1,8,76,130 
APPLICATION PROGRAM RESTARTS 151 
APPLICATION PROGRAM WORK AREA 149 
APPLICATION PROGRAMS THAT CURRENTLY TEST 74,132 
APPLICATION UNDER TCAM 137 
AREA 124,127,11,21,85,113 
AREAS 

1021-BYTE 21 

146,3,5,7,21,25,36,45,58,77,82,90 
92, 100,10 5, 10 8,111,114,121,132-133,135-136,139 
142,141,157,190,191,199 
ASCII 

32-33,35,54,62,66,20 6,15,56-57,68,203 
ASMBLR 19-20,13,201 
ASSEMBLER 109,13,108,209 
ASSEMBLER B 149 
ASSEMBLER B 4 149 
ASSEMBLER D 

USE OF 72 



ASSEMBLER END CARD 44 

ASSEMBLER END STATEMENT 13,91,100,117,106,109,113,115 

ASSEMBLER F 20 

ASSEMBLER H 20 

ASSEMBLER LANGUAGE 13,118,200,211 

ASSEMBLER LANGUAGE APPLICATION PROGRAM 158 

ASSEMBLER NAME 19-20,13,201 

FIRST THREE CHARACTERS OF THE 20 
ASSEMBLER PROGRAM 48 
ASSEMBLY 20,22,46-47,77 
ATDI 171 
ATP 14,16-17,19,22,44,53,204,146,156,19,201 

205 
ATP TASKS VALUE 

MAXIMUM NUMBER OF 153 
ATPMT 53,19,205 
ATPMT OPERAND 53 
ATTACH 110-111 
ATTRIBUTE BYTE 135-136 
ATTRIBUTE POSITION 
AUDALARM 131,55,70,189,207 
AUDIBLE ALARM 132 
AUDIBLE ALARM FEATURE 74 
AUDIO 62-63,54-55,70,72,206-207 
AUDIO RESPONSE DEVICE LVUNIT 72 
AUDIO RESPONSE UNIT UNDER CICS/DOS 179,182 
AUDIO RESPONSE UNIT UNDER CICS/OS 179,181 
AUTOANSR 196,181-183,54,62,67,80,184,186-188,2 06 
ADTOANSW 32,34,15,203 

AUTOCALL 137,196-197,54,62,67,80,184,188,206 
AUTOMATIC 67,54,62,206 
AUTOMATIC POLLING FEATURE 34 
AUTOMATIC TASK INITIATION 98-99,114,154 
AUTOPOLL 67,32,34, 15,54,56,62,164,203,206 
AVAILABLE TCTTE 144 



BASE NAME 114,48 

BASE REGISTER 128,117-118,121 

BASIC ERROR RECOVERY PROCEDURES 57 

BASIC MAPPING SUPPORT PROGRAM 177 

BASIC SEQUENTIAL ACCESS METHOD 32 

BASIC TELECOMMUNICATIONS ACCESS METHOD 32,66 

BATCH 62-63,54-55,70,72,206-207,3,152,215 

BATCH IMS JOB 9 

BATCH IMS/360 PROGRAMS 

EXECUTING 45 
BATCH TRANSACTION MAKES PROPER USE 174 
BDAM 82-84,199,81,92,86,207 
BEAM DATA SET 85 
BGAM 

62-63,65,32,72,137,196,15,54,189,202,206 
BINARY 63-64,72,76,57-60,68,127,179 
BINARY CODED DECIMAL INTERCHANGE CODE 59 
BISAM 45 

BISYNC 32,54-55,62-63,70,72,206-207,15,203 
BISYNC BINARY 33 

BISYNC PARAMETER INCLUDES 1130 31 
BISYNC 2 34 
BISYNCH DEVICES 67 
BLK 86,81,83,207 
BLKKEYL 86,82,84,81,199,207 
BLKKEYL OPERAND 87 
BLKKEYL VALUE 86 
BLKSIZE 56,60,86,102-104,190-191,95-96,54,81,83 

92,94,182,206-208 
BLKSIZE BYTES 9-16 160 
BLKSIZE PLUS BLKKEYL 199 
BLKSIZE VALUE 86 
BLOCK 84-86,60,96-97 
BLOCK SIZE 11 
BLOCKED 87 

BLOCKED BDAM DATA SET 88 
BLOCKING FACTOR 86,81 
BLOCKS 

NUMBER OF 1021-BYTE 52 

1024-BYTE 52 
BLOCKS FEATURE OF DL/I 

PRE-BOILT 46 
BLOCKSIZE 86,61 
BMS 32,37,15,203 
BNE 128 

BR 14 INSTRUCTION 119 
BROWSE OPERANDS 86 
BSAM 62-63,65-66,32-33,137,196,15,54,124,188 

202,206 
BSAM DATA SET CONTROL NAME 64 
BSAM STATUS 124 
BSAM STATUS 44 126 
BSCMDMPT 56,54,184-185,206 
BSCMDPPT 56,54,206 
BSCMDSW 56,54,187,206 
BSCODE 32-33,35,56-57,59,68,54,186-188,206,15 

62,184-185,203 
BSCODE OPERAND 
BTAM 163,166-168,62-64,66,32-33,37,24,59,120 

137,196,182-183,80,15,54,79,124,179-181,184 
185-187,189,202,206 
BTAM DEVICE TYPES 33 
BTAM DEVICES 77,73 

POLLING OF 154 
BTAM DFTRMLST MUST 

LABEL OF THE 73 
BTAM ENVIRONMENT 138 
BTAM I/O ERRORS 166 
BTAM INPUT ONLY 162,164 
BTAM LINE ERROR 

LABEL OF THE 60 
BTAM LINE GROUPS DEFAULTS 60 
BTAM LOCAL LINE GROUP 69 
BTAM MANUAL 66 
BTAM NON-SWITCHED LINE 72 
BTAM OUTPUT ONLY 163 



BTAM READ/WRITE RETURN CODE 164 

BTAM RETURN CODE 121,163-164,122 

BTAM SWITCHED-LINE PROCESSING 73 

BTAM-EXPANDED ID VERIFICATION 68 

BTAMDEV 32-34, 37, 24, 15, 57, 137,202 

BTAHDEV OPERAND 34 

BTAMDEV 2 32 

BOFEXP 131,55,70,207 

BUFEXP PARAMETER INCREASES 74 

BUFFRECV 67,32,34, 15,54,62,203,206 

BUFNO 102-103,95-96,94,208 

BUFPL 52,45,49,205 

BOILT 159-160,46,112,212 



CAA 23-24,14,201 
CAA OPERANDS 23 
CAAUTIPL 130 
CALL'S 

INDICATE WHAT TYPE OF 45 
CARD READER 57,60,63,72 
CARRIER CONTROL CHARACTERS 165-166 
CATP STOP 156 
CDL 49,51,205 

CHANNEL END/ABNORMAL END APPENDAGE ROUTINE 24,61 
CHECK 85,141,159,161,210,128,161,163 
CHECK OPERANDS 161 
CHECKING FEATURE 57-58 
CHK 56,58,54,79,180,206 
CICS 178,190,201 

ABNORMAL TERMINATION OF 151 

ACCESSED DURING EXECUTION OF 52 

ACTIVATE 11 

AUTOMATIC TASK INITIATION FEATURE OF 7 

CICS OPTIONS DURING GENERATION OF 45 

DUMP MANAGEMENT FACILITY OF 11 

FILE CONTROL FACILITIES OF 

GENERATION OF 13,18,176 

INITIALIZATION OF 48 

NAMES OF 22 

NEW RELEASES OF 116 

OPERATION OF 110 

OS SUBTASK OF 9 

REAL-TIME EXECUTION OF 

USER OF 111,113,154 
CICS APPLICATION PROGRAM 
CICS ATTACHES TIOA 142 
CICS CATALOGED PROCEDURES 19 
CICS CHECKING 150 
CICS CONFIGURATION 52 
CICS CONTROL BLOCKS 138-139 
CICS CONTROL TABLES 176 
CICS DFHTCT TYPE 132,139 
CICS DUMP UTILITY PROGRAM 7 

CICS DYNAMIC OPEN/CLOSE FACILITY ALLOWS 155,158 
CICS DYNAMIC OPEN/CLOSE PROGRAM 103-104 
CICS EXECUTION 

COURSE OF 162 
CICS EXECUTION DECK 24 
CICS FILE MANAGEMENT 82 
CICS FUNCTIONS 

CHOICE OF 10 
CICS MACRO INSTRUCTIONS 

FOLLOWING LISTING OF 200 
CICS MANAGEMENT FUNCTIONS 116 
CICS MANAGEMENT PROGRAMS 39,116-118,37,40-42,10,27 

30,5,13,27,28,148,10 
CICS MASTER TERMINAL SWITCH FUNCTION 11 
CICS NUCLEUS 51 

52,83,93 
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24,155,158 
61,138,151 



146 
77,145,179,190 



CICS PARTITION/REGION 
CICS PROGRAMS 6 

ASSEMBLY OF 22 

LINK EDIT OF 22 
CICS SCREEN CONTROL MACRO INSTRUCTIONS 147 
CICS STORAGE 

12-BYTE 149 
CICS SYNAD 61 
CICS SYSTEM DATA SETS 22 
CICS SYSTEM INITIALIZATION 

COMPLETING 150 
CICS SYSTEM INITIALIZATION PROGRAM 6,156 
CICS TABLE PREPARATION 131 
CICS TASK 67 
CICS TASK ISSUES 67 
CICS TERMINAL 145-146 
CICS TERMINAL CONTROL PROGRAM 
CICS TERMINAL CONTROL TABLE 

EXAMPLE OF A 190 
CICS TERMINAL CONTROL TABLE CONTAINS 138 
CICS TERMINAL ERROR HANDLING STRUCTURE 120 
CICS TERMINAL ERROR PROGRAM 138 

EXPANSION OF THE 143 
CICS TERMINAL INPUT/OUTPUT AREA 149-150 
CICS TERMINAL OPERATOR GUIDE 106,110 
CICS TIOA 140 
CICS TRACE FUNCTION 154,153 
CICS TRACE TABLE 50 
CICS TRANSACTION 136 

CICS TRANSACTION ROLLOUT DATA SET 50 
CICS TRANSIENT DATA CONTROL FACILITY 162 
CICS USER EXITS 148 

CICS USES FOUR-BYTE TERMINAL ID'S 149 
CICS UTILITY PROGRAM 1 
CICS 2260 COMPATIBILITY 132,135 
CICS.LOADLIB 22 
CICS-DL/I INITIALIZATION 45 
CICS-DL/I INTERFACE 52,45-46 
CICS-DL/I INTERFACE MODULES 

LINK EDIT OF THE 22 
CICS-DL/I INTERFACE USES 46 
CICS-PROVIDED PROGRAMS 
CICS-PROVIDED UTILITY PROGRAM 11 
CICS-TO-TCAM COMMUNICATION BYTE ALL SOH 14E 



88,157,160,185,189,194,199 

GENERATION OF 13 
CICS/DOS ENVIRONMENT 11 
CICS/DOS EXTENT CARD 96 
CICS/DOS LINKAGE EDITOR 13,95 

GENERATION OF THE 19 
CICS/DOS OPERATIONS GUIDE 91 

CICS/DOS REAL-TIME RELOCATABLE PROGRAM LIBRARY 13 
CICS/DOS REAL-TIME SYSTEM 1*3 
CICS/DOS SYSTEM DATA SETS RESIDE 50 
CICS/DOS SYSTEM GENERATION 

NUMBER TERMINATION OF 204 

TERMINATION OF 44 
CICS/DOS SYSTEMS 

56-6 0,83-85,19-21,23-24,31,34-35,50 
CICS/DOS-ENTRY 53,68,137,169,187,214 

CICS/DOS-ENTRY SYSTEM 26-27,50-51,6,38,41,53,109,154,162 
CICS/DOS-STANDARD 53,6,109,196 
CICS/DOS-STANDARD SYSTEM 6,22,41,53 
CICS/OS 57-61,95-96,77-78,160,20,62,65,69,5 
19,51,82,86,88,100,122,189,194,199 

GENERATION OF 13 

USER OF 86-87 
CICS/OS APPLICATION PROGRAMS OPTIONAL ACCESS 45 
CICS/OS DATA LANGUAGE/1 FACILITIES 

GENERATION OF 22,45 
CICS/OS ENVIRONMENT 11 
CICS/OS ISAM DATA SETS 
CICS/OS OPERATIONS GUIDE 
CICS/OS STANDARD SYSTEM 



87 

39,46 
21,24 



CICS/OS STANDARD VERSION 2.3 41 

CICS/OS SYSTEM 32,37,83,85,19,42-43,56,69,72,88 



CICS/OS VERSION 1 
CICS/OS VERSION 1 
CICS/OS VERSION 2 
CICS/OS 3 194 
CICS/OS-STANDARD 
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USERS 



22 



22,24 



CICS/OS-STANDARD SYSTEM 20-22,57-58,60-61,52-53,24, 

6,35,43,51,85,109,129 
CICS/OS-STANDARD VERSION 1 USER 129 
CICS/OS-STANDARD V1 5 

CICS/OS-STANDARD V1 COMPATIBILITY 33 
CICS/OS-STANDARD V2 5 
CICS/TCAM ABEND/RESTART 151 

CICS/TCAM INTERFACE 145-146,138-139,147-148,150-151 
CICS/TCAM INTERFACE CONSIDERATIONS 37,69,137 
CICS/TCAM INTERFACE ENABLES CICS 137 
CICS/TCAM INTERFACE IMPLEMENTATION 143 
CICS/TCAM INTERFACE SUPPORTS 143 
CICS/TCAM PROGRAM INTERRELATIONSHIP 190 
CICS/TCAM STARTUP 150 
CICS/TCAM TERMINATION 151 
CICSGEN 20,201 

CLASS 19,21,54-55,62-63,70,72,206-207,14,189 
CLOSE 161-162,158-159,153,192,210 
CLOSE DATA SETS 161,11 
CLOSE ERROR 20 161 
CNTRL 56,54,236 

COBOL 28,43,108,14,16,18,202,109-110,204,209 
COBOL DFHPPT TYPE 110 
CODED DECIMAL INTERCHANGE CODE 2 68 
CODES 

CODING 79-80,92-93,107,110,113,90,93,115,179 
CODING DFHSG TYPE 45 

COMMON CARRIER TELETYPEWRITER EXCHANGE TERMINAL 33,179,184 
COMMON SYSTEM AREA 42,156 

EXTENSION OF THE 5 
COMMON SYSTEM ARIA KCP 51 
COMMON TCTTE'S 

POOL OF 139 
COMMON WORK AREA 

OPTIONAL USER-DEFINED 5 
COMMUNICATE 68,61,76,108 
COMMUNICATION LINES 34,65-66,68,71 

COMMUNICATION TERMINAL/2760 OPTICAL IMAGE UNIT 180 
COMPAT 32,35-36,106,70,74,185,15,55,105,131,177 

189,203,207,209 
COMPAT OPERAND 

SINGLE USE OF THE 36 

USE OF THE 74 
COMPAT OPERANDS 148 
COMPATIBILITY MODE 136,131 
COMPATIBILITY OPERATION 

FULLBUF MODES OF 106 

TWO MODES OF 36,130 
COMPATIBILITY TRANSACTION 136 
CONFIG 56,59,54,186-187,206 
CONSEC 26,14-15,38,201,203 
CONSECUTIVE I/O 

NUMBER OF 26 
CONSECUTIVE I/O EVENTS 

NUMBER OF 38 
CONSOLE OPERATOR 157 
CONTINUE RESPONSE 151 
CONTROL DUMMY 

CONTROL PROGR DUMP 17 

CONTROL PROGR FILE 17 
CONTROL PROGR ABNORMAL CONDITION 17 
CONTROL PROGR CICS DUMMY CSA 17 
CONTROL PBOGR COMMON SYSTEM AREA 17 
CONTROL PROGR DUMP UTILITY 17 
CONTROL PROGR PROGRAM INTERRUPT 17 
CONTROL PROGR SYSTEM SERVICE PROGRAMS 
CONTROL PROGR TABLE 1 17 
CONTROL PROGR TEMPORARY STORAGE 17 
CONTROL PROGR TRANSIENT DATA DUMMY 
CONTROL PROGRAM 

GENERATED AS PART OF THE FILE 26 
CONTROL SECTION 211-212,82,105,108,111,114 
CONTROL SYSTEM DUMMY GROUP 25 
CONTROL SYSTEM MANAGEMENT PROGRAMS 26 
CONTROL SYSTEM MESSAGES 162 
CONTROL SYSTEM OPERATIONAL GROUP 23,201 
CONTROL SYSTEM SERVICE GROUP 24 
CONTROL SYSTEM UTILITY GROUP 25 
CONTROL UNIT 56,59,123,126,173 
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17 



3271 66,74 
CONTROL UNIT 31 

REMOTE 3271 33 
CONTROL ONIT 33 

REMOTE 3271 33 
CONTROL VALUE 66 

CONV 62-63, 51-55,70, 72, 206-207 y 
CONVTAB 32-33,35-37,181-183,15,54,57,62,68,203 

206 
CONVTAB OPERAND 

SINGLE USE OF THE 36 
COORDINATING MCP 151 
COPY CSA SYMBOLIC STRG DEFN 211 
COPY DFHXXEXT STATEMENT 117 
COPY FEATURE 71,132,171 
CREATE SUPERSET ISAM LOGIC MODULE 91 
CREATING USER EXITS 39,37,40-42,27,30,28,148 
CRLP 

62-63,70,72,32,54-55,188,206-207,15,202 
CSA 42,16-17,117,204,5,26,38,156,49,205 

COMMON WORK AREA PORTION OF THE 42 
CSACTODB 156 
CSAJYDP 156 
CSAKCCDL 26,38 
CSAOSRSA 117 
CSAOSRSA BALR 4,0 117 
CSAPCTBA 211-212 
CSATADJT 156 
CSD 17,25,201 

CSD CONTROL SYSTEM UTILITY GROUP 201 
CSD MACRO INSTRUCTION 30-31,39-40,42,18,25 
CSECT 49-50,205 
CSML 176 

CSML EXPLANATION 174 
CSMT 177,11,176,107,155 
CSMT EXPLANATION 162-169,171-174 
CSMT FILE SERVICE FUNCTIONS 38 
CSO 14,17,23,201,21,157 

CSO MACRO INSTRUCTION 61,18 „' 

CSOT 177 
CSS 17,24,201 
CSSF 177 
CSSL 158,176 
CSSN 177,107 
CSST 177,107 
CSTA 107,157,177 
CSTT 177 
CSU 14,17,25,201 
CSXX 177 
CTLCHAR 148 

CU 56,59,79,54,80,179-181,184,186-189,206 
CURRENT DATE 156 
CURRENT DUMP DATA SET 162 
CURRENT RECORD 145 

CURRENTLY OPERATIONAL 2260-BASED TRANSACTIONS 35,130 
CUSHION 154 
CWA 5 
CWTR 178 
CYLOFL 82,84,81,207 



DAM 38,85-87,7-8 

DAM DATA SETS 83-84,86,8 

DAM FIXED-LENGTH DATA SETS 86 

DAM KEYED DATA SETS 85 

DASD 62-63,32,56,54-55,206-207,70,72,15,79 

188,202 
DATA AREA 

PRIME 84-85,9 
DATA BASE BUFFER POOL SIZE 52 
DATA BASE CONSIDERATIONS 8,86,88 
DATA BASE DESCRIPTIONS 46 

DURING GENERATION OF IMS 82 
DATA BASE STATISTICS PROGRAM 178 
DATA BASE SYSTEM 2,9 
DATA BASES 3,2,5,7,52,82 

ADDRESS OF 119 
DATA CHECK 166-167,58 
DATA DEFINITION 60-61,96 

DATA DESTINATION CSSL AS VARIABLE-LENGTH 157 
DATA ENTRY KEY 36,131,134 
DATA EVENT CONTROL BLOCK 61 
DATA EXTENT CONTROL BLOCK 120 
DATA FIELDS 87,134 
DATA FORMAT 140 
DATA LANGUAGE/1 2,9,22,45 
DATA MANAGEMENT BLOCK 52 
DATA MANAGEMENT BLOCK DIRECTORY 22 
DATA MANAGEMENT MACRO INSTRUCTIONS 60,97 
DATA MANAGEMENT STATISTICS PROGRAM 23 
DATA QUEUE 215 
DATA RECORD 145,99 
DATA SET 

DATA BASE 154-155,15 8-159 

OBJECT 88 
DATA SET CONTROL BLOCK 97-98,100,103-104,93,95,109 
DATA SET CONTROL BLOCK DEFINITIONS 100 
DATA SET CONTROL BLOCKS 
DATA SET CONTROL INFORMATION 57,63 
DATA SET CONTROL NAME 64,95 
DATA SET RECORD 

DESCRIBE CROSS-INDEX 87 
DATA SETS 86-87,92,82-85,88,98,2,5,8-9,11 

24,48,60,64,81,89-9 0,96,99,104,155,158 
159,161,199 

DATA LANGUAGE/I 9 

NAMES OF THE 160,88,97,161 

PHYSICAL CHARACTERISTICS OF THE 82,199 
DATA STREAM 136,130,133,135 
DATA WRITE LOOP DFHTD TYPE 215 
DATABASE 160,159,210,161 

DATASET 160,82,161-162,81,159,210,92,207 
DATASET MACRO INSTRUCTION 82,199 



157 



160,71,149 



143 
178 



74,132 



DAUPD 38,15,203 
DAY 

CICS TIME OF 157 

OPERATING SYSTEM TIME OF 

SPECIFIED TIME OF 30 

TIME OF 156-157,178,1 
DAY CONTROL 

TIME OF 156 
DBD'S 46,82 
DBROWSE 38,15,203 

DCB 86-87,61,160-161,8 2,9 5,138-139,192-193,165,181 
DCB RECORD FORMAT 81,83,207 
DCB VALUE 86 
DCBNAME 95 

DCP 15,17,31,202,49,205 
DCP MACRO INSTRUCTION 31 

DCT 93,102,104,49,51,100,162,171,40,176,178,20 5,208 
DCT ASSEMBLY 160 
DCT ENTRY 

ADDRESS OF 119 
DD 60-61,44,96,72,102-103 
DD CARD 138,164 
DDIR 46,22 

DDNAME 56,60,138,95,16 0,190-192,54,186-187,206 
DEBLOCKING TECHNIQUE 88 
DEC 124-125,86,81,83,207 
BECAD 38,15,203 
DECB 61,120-121,124 

DECIMAL VALUE 49-51,105,53,82,84,81,207 
DEFAULT VALUE 67,21,53,74,77,96,131 
DESCRIPTION 7770 AUDIO RESPONSE UNIT 77 
DEST 143,193,142 
DESTFAC 98-99,94,101,208 

DESTID 102-104,93-94,101,176,208-209,215,97-99 
DESTID OPERAND 161 
DESTINATION 98-99,97,160,101,142-143,145 

ULTIMATE 98-99 
DESTINATION CONTROL TABLE 93-94,100,40,71,94,109,162,176,103-104 
DESTINATION CONTROL TABLE BEFORE 
DESTINATION CONTROL TABLE CSA 51 
DESTINATION CONTROL TABLE EXAMPLES 100 
DESTINATION CONTROL TABLE MACRO INSTRUCTIONS 93 
DESTINATION CONTROL TABLE USING 99 
DESTINATION CSMT 169,127 
DESTINATION FIELD 

EIGHT-BYTE 149,61 
DESTINATION IDENTIFICATION 
DETECTING PROGRAM 169 
DEVADDR 31,102-104,56-57,79,95-96,188,15,54,94 

101,202,206,208 
DEVADDR VALUE 31 
DEVICE ADDRESS 31,73,122,171 
DEVICE DEPENDENT CONSIDERATIONS 
DEVICE-DEPENDENT OUTPUT PROGRAM 
DEVICE-DEPENDENT 2260 DATA STREAMS 
DFH 200 

DFHACP 162,169,17,23,176-177 
DFHAQP 17,44,176-177 
DFHASMV2 22,201 
DFHATP 53,169,44,17,176-177 
DFHAUPLK 22,201 
DFHBMSMM 37,17,177 
DFHCAA70 18,23 
DFHCSA 17,51 
DFHCSADS 211-212,214,117 
.DFHDCP 17,51 
DFHDCPDY 17 
DFHDCSA 17,52 
DFHDCT 93-94,51,94 
DFHDCT MACRO 80 
DFHDCT MACRO INSTRUCTION 
DFHDCT TYPE 

97,93-94,98-99,176,95,102-103,20 8,100-101 
DFHDCT22 103 
DFHDEB70 18,23 
DFHDLA 18,23 
DFHDLDBD 46 
DFHDLDBD TYPE 47 
DFHDLE 18,23 
DFHDLI 18,23 
DFHDLIDY 18,23 
DFHDLPSB PSB 46 
DFHDLPSB TYPE 46 
DFHDLQ 18,23,46 
DFHDMPA 7,155 
DFHDMPB 7,155 
DFHDUP 11,17,25 
DFHFCP 17,51,10 
DFHFCPDY 17 
DFHFCPXX 49 
DFHFCT 51,82 
DFHFCT MACRO 84 

DFHFCT MACRO INSTRUCTION 80-81 

DFHFCT TYPE 83,90,87-89,91,81-82,199,93,207-208,90 
91-92 

SERVREQ OPERAND OF THE 88 
DFHFCTXX DESTINATION CONTROL TABLE 48 
DFHFEP 17,25,176-177 
DFHGAP 17 

DFHIC MACRO INSTRUCTION 30 
DFHICP 10,17,51 
DFHICPDY 17 
DFHKCP 10,17,51,119 
DFHKCPB1 TASK CONTROL MODULE 51 
DFHLINK 19,21,6,95,13 

GENERATION OF 19 
DFHLNKV2 22,201 
DFHMTP 11,177 
DFHMTPA 176,17,177 
DFHMTPA DFHPCT TYPE 107 
DFHMTPA DFHPPT TYPE 110 
DFHMTPB 17 
DFHNPL 19 
DFHOC 158 
DFHOC MACRO INSTRUCTION 158 

EXPANSION OF THE 161 



USE OF THE 87,158 
DFHOC TYPE 161,159,162,210 
DFHOCLDS 159 
DFHOCODS 160 
DFHOCP 17,104 
DFHPC MACRO INSTRUCTION 75 
DFHPC TYPE 28,75,120,130 

EXECUTION OF THE 130 
DFHPCP 10,17,51,119 
DFHPCT 51,105 

DFHPCT MACRO INSTRUCTION 105 
DFHPCT TYPE 105,131,176,106-107,209 
DFHPCTXX 48-49 
DFHPIP 51,17 
DFHPL1I 43 
DFHPL10I 43,18 
DFHPPT 51,108 

DFHPPT MACRO INSTRUCTION 108 
DFHPPT TYPE 109,97,108,177,209,109-110 
DFHPPTXX 48 
DFHPRPR 18,43 
DFHRD1 17, 44, 176-177 
DFHRD2 17,44 
DFHRPL 19,97,100,109,13 
DFHRPL AS DFHTRNAA 103 
DFHRPL USING DFHLINK 104 
DFHRWP70 18,23 
DFHSAP 18,43 
DFHSCEXT 117 
DFHSCP 10,17,51,117 
DFHSFP 17,25,177 
DFHSG 13,18 

DFHSG MACRO INSTRUCTION 13,5 
DFHSG PROGRAM 23-24,30-31,38-39,41-42,26-29,32,42 

43-44,110,137,157,14,16,18,201,25,68,117 
201-204 
DFHSG TYPE 23,29-30,13,19-20,44,129,201,204 

OPERAND OF 24,27 

PARAMETERS OF 21 

TCTUA OPERAND OF THE 69 
DFHSI 53 
DFHSIP 23-24,17,19,11,52 

EXCESS OF THE SIZE OF 52 

SIZE OF 52 
DFHSIP PLUS 
DFHSIT 48,50 

DFHSIT MACRO INSTRUCTION 49 
DFHSIT MACRO WHICH 
DFHSIT TYPE 49,205 

DFHSITXX TERMINAL CONTROL TABLE 48 
DFHSIUS 53 

DFHSNP 177,17,25,176,107 
DFHSNT 111,168,177 
DFHSNT MACRO INSTRUCTION 111 
DFHSNT TYPE 112,111,209,113 
DFHSTKC 177-178,11,23,176 
DFHSTP 11,23,18,177 
DFHSTTD 11,23,18,178 
DFHSTTR 11,23,18,178 
DFHTACLE 120,128 
DFHTACP 123-124,126,128,120,162,169,23-24,146,178,17 

129,121-122,176 
DFHTACP/DFHTEP 148 
DFHTAJP 157,17,23,176,178 
DFHTC TYPE 147-148,130,123,142,173 

DEST OPERAND OF THE 143 

SERIES OF 130 
DFHTCADS 211-212,214,117 
DFHTCP 120,51,10,17 
DFHTCT 53,55,51 
DFHTCT MACRO 19 
DFHTCT MACRO INSTRUCTION 53 

OPERANDS OF THE 194 

TRMIDNT OPERAND OF THE 115 

USES OPERANDS OF THE 194 
DFHTCT TYPE 70-73,76,61-63,65-69,137,35,179,56,60 

78-79,144,24,131-132,138-139,182,197,189,80 
179-180,18 7,190-191,54-55,76-77,180-181,184 
185-188,206 

NAME OPERAND OF THE 57,62 

OPTCD OPERAND OF THE 143,141 

TRMIDNT OPERAND OF THE 98 
DFHTCTBA TCAM MESSAGE CONTROL PROGRAM 192 
DFHTCTLE 120,128 
DFHTCTTE 211-212,214,128 
DPHTCTXX FILE CONTROL TABLE 48 9 
DFHTD 97-99 
DFHTDCP 17,178 
DFHTDIA 214 
DFHTDP 17,51,176,10 
DFHTDPDY 17 

DFHTEP 123-124,126-127,120,23-24,143,17,121,129,138 
162,146,178 

USER-WRITTEN 121,146,173 
DFHTEP PROGRAM 137 

DFHTEP PROGRAMMING CONSIDERATIONS 121 
DFHTEP RECURSIVE RETRY ROUTINE 127 
DFHTIOA 211-212,214 
DFHTLT 114 

DFHTLT MACRO INSTRUCTION 114 
DFHTLT TYPE 114-115,209 
DFHTLTXX 114 
DFHTR 28 
DFHTRNAA 103 
DFHTRNBB 103-104 
DFHTRNCC 103-104 
DFHTRNDD 103-104 
DFHTRNXX 97,100,178 
DFHTRP 51,23,18 
DFHTRPDY 23,50 
DFHTSP 10,17,51 
DFHTSPDY 17 
DFH0PDV2 22,201 
DFHWT1 17,44,176,178 
DFHWT2 17,44 
DFHXTRA 101 



DFH1500 150 
DFH1520 150 
DFH1701 156 
DFH1702 156 
DFH1791 156 
DFTRMLST 65-66,71,75,68 

SPECIFY NAME OF 197 
DFTRMLST ENTRIES SHOULD 66 
DFTRMLST HACRO DEFINITIONS 77 
DIAL-UP 33,179,77,196 
DIAL-UP CONNECTION 67-68 
DIRECT ACCESS 38,7-8,33 
DIRECT ACCESS DEVICE 33,57,72 
DIRECT ACCESS STORAGE DEVICE 63,110 
DISCONNECT PARAMETER 147 
DISCONNECT SWITCHED LINE 

DEFAULTS OF 129 
DISCONNECTS 147,123,126,121,214 
DISK 3 2-33,56-57,70,192,1-2,11,15,54,179 

202,206 
DISPLACEMENT 124-125,88-89 
DISPLACEMENT SEGLENG 89 
DISPLAY STATION SMI 

1920-CHARACTER 3275/3277 36 
DISPLAY STATION 2 

480-CHARACTER 3275/3277 36 
DL/I 22,82,2,9,45,52,81,207 
DL/I ABEND 171 
DL/I APPLICATION PROGRAM 23 
DL/I CALL EXECUTION PROGRAM 23 
DL/I DATA BASE 83 
DL/I INITIALIZATION PROGRAM 23 
DL/I INTERFACE 171 
DL/I INTERFACE DUMMY PROGRAM 23 
DL/I INTERFACE PROGRAM 23 
DL/I MODULES 
DL/I REQUIRES 

USE OF 2 
DL/I UNDER CICS 9 
DLIA 171 
DLPA 171 

DL1 23,19,22,4 5,52,14,46,49,201,20 5 
DMB 52 

DMB DIRECTORIES DURING CICS GENERATION 46 
DMB DIRECTORY LIST 46 
DMBPL 52,45,49,205 
DOS 28,1,20,29,122 

DOS BASIC TELECOMMUNICATIONS ACCESS METHOD 58 
DOS CORE IMAGE LIBRARY 53 
DOS DISK OUTPUT DATA SETS 96 
DOS FILE NAME 83 
DOS ISAM DATA SETS 86,84 
DOS ISAM VARIABLE-LENGTH RECORDS 9 
DOS LBLTYP JOB CONTROL STATEMENT 24 
DOS SUBSET COMPILER 28 

DOS SUBSET/SUPERSET LOGIC MODULE FACILITY 96 
DOS SUPERVISOR 85 
DOS SYSTEM 20,23 
DOS-ENTRY ONLY 24 
DOS-ENTRY SYSTEM 109 
DSCNAME 62-64,56-57,95,102-104,190-191,79,182-183 

80,206,54,94,101,179-181,184-189,208,97 
DSCNAME OPERAND 77 
DSECT 19,49,120,205 
DSETID 159-161,210 
DSETID OPERAND 

SINGLE USE OF THE 160 
DSIZE 19-20,13,201 
DTF 82,95,160,79,182 
DTF40B DFHTCT TYPE 181 
DTF40MD 80 
DTF40MD FIGURE 2 79 
DTF41C 181 

DTF41C DFHTCT TYPE 181 
DTF60L 79,189 
DTF60L DFHTCT TYPE 79 
DTF60L LINE1 DFHTCT TYPE 189 
DTF60R 180 

DTF60R OPL2260 DFTRMLST OPENLST 180 
DTF7770 182-183 

DUMMY 15-16,29-31,38-42,166,70,202-203 
DUMMY CONTROL SYSTEM OPERATIONAL PROGRAMS 17 
DUMMY CSA 42 
DUMMY CSA PROGRAM 52 
DUMMY DFHTEP 120 
DUMMY DUMP CONTROL PROGRAM 31 
DUMMY FCP 51 

DUMMY FILE CONTROL PROGRAM 39 
DUMMY INTERVAL CONTROL PROGRAM 29-30 
DUMMY PROGRAM 18,25,30-31,39-40,42 
DUMMY TDP 51 

DUMMY TEMPORARY STORAGE CONTROL PROGRAM 42 
DUMMY TERMINAL 126-127,167 
DUMMY TRANSIENT DATA CONTROL PROGRAM 40 
DUMP 160,156,159,210,1,4,12,155,161,171 
DUMP APPENDIX G 210 
DUMP CONTROL DATA SET 31 
DUHP CONTROL PROGRAH 31,7 
DUMP CONTROL PROGRAM ICP 51 
DUMP DATA SET 11,153,155,158-159 
DUMP MACRO INSTRUCTION 162 
DUMP MANAGEMENT 1,155,158 
DUMP MANAGEMENT 7 4 
DUMP OPEN DATA SETS 159 
DUMP UTILITY PROGRAM 4,12,25 
DUMP X'90 RETURN 170 
DUPDSID 88,81,92,208 
DUPLICATES DATA SET 88,91,92 
DYNAMIC OPEN/CLOSE FACILITY 93,177 

USE OF THE 104 
DYNAMIC OPEN/CLOSE FUNCTION 104 
DYNAMIC OPEN/CLOSE PROGRAM 43,109,161,177 
186-188,203,184 



43 
131 a176- 177, 105, 108, 112 



-E- 

EBCDIC REPRESENTATION 211 

ECB 140 

END STATEMENT 46-47 

ENDLESS SCREEN 133 

ENQUEUE 26,14,201 

ENTER KEY 134 

ENTRY INTERFACE PROGRAM 

ENTRY MACRO INSTRUCTION 

2760 INPUT ED 212 
ENVIRONMENT 3,5,7,53,152 

RESTRICTED 144 
EOF CONDITION 174,121,123 
EOH 133 

AUTO 212-213 
EOT 123 

EQU 211-213,215,193 
ERASE 147 
ERASEAUP 148 

ERROPT 56-58,60,95,97,54,94,206,20 8 

ERROR 163-164,170-171,125,128,161,57,95,97,120,181,183 
ERROR CODES 121-123,143 
ERROR CONDITION 121,129,146,171 
ERROR MESSAGE 76,68,174 
ERROR STATUS 173,122 
ERROR STATUS MESSAGE 173 

ESTABLISH BASE ADDRESS REGISTER USING 711-212 
ESTABLISH CONTROL SECTION 108 
ESTABLISH SIGN-ON TABLE CONTROL SECTION 111 
EVENT COMPLETION TRANSIENT DATA CONTROL 10 
EVENTS X'80 WAIT 
EXCLUSIVE CONTROL 38 

EXCLUSIVE CONTROL DUMP DATA SET 155 
EXCTL 38,15,203 
EXEC CARD 11 
EXECUTE 170 
EXECUTE CICS 10 
EXECUTION UNDER CICS 4 

EXIDVER 62,66,32,59,137,196,15,54,68,2 03,206 
EXISTING CUSHION 154 
EXISTING DFHTEP 24 
EXIT 118,143,149,215 
EXIT ROUTINE 

USER-WRITTEN 39,37,40-42,116,119,27-28,30,14 8-149,178 
EXIT ROUTINES 116,118 
EXITS DFHTCP 141 
EXPAND 120,4 
EXPIRATION TIMES 157 
EXPLANATION 

CSTL 164-165,173 
EXTENT 82,84,81,207 

EXTRAPARTITION DATA SET 40,93,155,158,171,214 
EXTRAPARTITION DESTINATION 103-104,99,101 
EXTRAPARTITION MVC 215 



FLAGS 

FLNNAHE 

FHT2260 

FMT3270 

FORMAT 



36,131 



FIXED-LENGTH 92-93 

FIXED-LENGTH DAM DATA SET RECORD 7 

FIXED-LENGTH PCI FIELD 

CASE OF A 69 
FIXUNB 95-96,94,102-103,101,208 
124,126,128 

56,60,54,182,189,206 
32,36,15,203 
15,32,203 
32,36,105,130-131,81,89,207-208,15,19,66 
83,87,114,136,149,203,20 9 
DISCUSSION OF 106 
FORMAT MODE 106 
USE OF 133,36 
FORMAT MODE TAKES FULL ADVANTAGE 
FOUR-BYTE DESTINATION ID 160 
FOUR-BYTE FIELD TCTTEDES 143 
FOUR-BITE LLBB FIELD 87 
FREE TERMINAL STORAGE 126 
FULLBUF 32,36,15,130,133,203 
FULLBUF' CONVERSION 

CASE OF 480/480 136 
FULLBUF MODE 106,136,36,131 
FULLBUF MODE LIMITS 

USE OF 36,134 
FULLBUF TRANSID 105 

FULLBUF 2260 COMPATIBILITY THROUGH 131 
FUNCTION 212-213,1,4,7,91,113,116.135,146 
SIGN-ON/SIGN-OFF 177 



GAN 64,66,166 

GAHA 101 

GAP 17,43,204 

GA27-2712 77 

GC24-5037 

GC26-3746 

GC28-6550 

GC28-6647 

GC28-6704 

GC30-2004 

GC30-2024 

GC30-3001 

GC30-5001 

GC34-0013 

GE 21,45 

GENERATE LINKAGE 

GENERATE SEGSET 

GENERATE TCAM SUPPORT 24 

GENPOLL 68-69,54,62,206 

DISCUSSION OF 66 
GH20-1028 50 
GRAPHIC 62-63,196,54,206 
GRAPHIC ATTENTION PROGRAM 
GRAPHICS ACCESS METHOD 60 



85,60,97 

85 

24 

60,97 

21-22 

60,66,164 

61,138,143,149,151 

137 

58-60,66 

130 



37,39-42,27,30,28,148-149 
89 



F.E. TERMINAL TEST PROGRAM 25 

FBS 87 

FCP 15,17,38,203,49,205 

FCP MACRO INSTRUCTION 39 

FCT 86,39,80,85,199,207,49,51,205 

FCT VALUE 86 

FDP HEADER RECORD 214 

FDP RECORD 214-215 

FDP TRAILER RECORD 214 

FEATURE 

56-58,32-35,66-67,70,74-75,137,196,182 
FEATURE OPERAND 34,132 

USE OF THE 75 
PEATURE PROGR CICS PREPROCESSOR 18 
FEATURE PROGR DL/I APPLICATION 18 
FEATURE PROGR DL/I CALL EXECUTION 18 
FEATURE PROGR DL/I INITIALIZATION 18 
FEATURE PROGR DL/I INTERFACE DUMMY 18 
FEATURE PROGR HIGH-LEVEL LANGUAGE PROGRAMS 18 
FEATURE PROGR PL/I INTERFACE 18 
FEATURE PROGR PL/I-OPT ENTRY INTERFACE 18 
FEATURE PROGR 7770 CHANNEL/ABNORMAL 18 
FIELD OF THE TACLE LABELED TCTLEECB 
FILABL 95-96,94,208 
FILE 98-99,94,6-8,23,80,88,96,208 
FILE CONTROL 25-26,116 
FILE CONTROL AREA 88 
FILE CONTROL PROGRAM 2 25 
FILE CONTROL TABLE 82,80,8,39,84,89,91-93 

ASSEMBLY OF THE 48 

DISCUSSION OF THE 9 

PREPARATION OF THE 199 

SPECIFY END OF 91 
FILE CONTROL TABLE CONFIGURATOR 199 
FILE CONTROL TABLE DCT 51 
FILE CONTROL TABLE EXAMPLE 91 
FILE CONTROL TABLE LISTING 

END OF THE 91 
FILE MANAGEMENT 2,82,155,158,80,89,116 
FILSERV 43,38,15,203 
FILSERV OPERAND 38 

FINAL DYNAMIC OPEN/CLOSE MACRO INSTRUCTIONS 209 
FINAL FILE CONTROL TABLE 207 
FINAL MACRO INSTRUCTION 179,44,76-77,91,95,100,106, 

109,113,115 
FINAL PROGRAM CONTROL TABLE 209 
FINAL SIGN-ON TABLE 209 
FINAL SYSTEM INITIALIZATION TABLE 204 
FINAL TERMINAL LIST TABLES 209 
FIOA XTYPHEQ 

ADDRESS OF 119 
FIXBLK 95-96,94,102-103,208 
FIXED FORMAT 89 
FIXED LENGTH 

PCI FIELDS OF 69 

PCI'S OF 5 



HARDCOPY 62-63,54-55,7 0,72,206-207 

HARDWARE BUFFER 122 

HARDWARE BUFFER EXCEEDED 8C 125 

HARDWARE BUFFER SIZE 165 

HARDWARE DIFFICULTY 172 

HDAM 45 

HEADER 215,75 

HEADER PORTION 89 

HEXAD 38,15,203 

HEXADECIMAL F'S 

REPRESENTS FOUR BYTES OF 159 
HEXADECIMAL FF 9,160 
HEXADECIMAL RELATIVE TRACK 38,86 
HIDAM 45 
HIDAM DATA BASE 

INDEX DBD OF A 46 
HIGH-LEVEL LANGUAGE FEATURE 18 
HIGH-LEVEL LANGUAGE SUPPORT GROUP 4 
HISAM 45 

CASE OF 52 
HLL 16,18,43,204 
HLITR 28,14,202 
HOLD STATUS 156 
HSAM 45 



I/O ERROR 168 

I/O ERROR INFORMATION 120 

I/O MACROS 85,60 

I/O OPERATIONS 59 

IADADHI 88,81,208 

IADIII 88,81,92,208 

IBROWSE 38,15,203 

ICE 30,119 

ICP 14,17,29,202,20,45,49,205 

ICP SPECIFICATION 157 

ICPAUTO 29-30,26,14-15,202 

ICPTIHE 157,26,29,14,201-202 

ICVR 49,51,205 

ICVS 49-50,205 

ID VERIFICATION 58-59 

IDENTIFICATION FIELD 

IEUASM 20 

IMS/360 2,9,45,82 

IMS/360 ACB LIBRARY 46 

IMS/360 CTL 

IMS/360 VERSION 2 

INSTALLATION OF THE 2,9 
INAREAL 60,182-183,191,62,64,79-80,54,180-181,184 
185-189,206 



INAREAL VALUE 64 

INDA 38,15,203 

INDACC 82-83,88,81,207-208,92 

INDAREA 82,84,81,199,207 

INDAREA OPERAND 84 

INDEX 46,92 

INDEX DATA SET 92 

INDEXED SEQUENTIAL ACCESS METHOD 7 

INDICATOR 01 

SPECIAL 125 
INDICATORS 128 
INDIRACC 38,15,203 
INDIRECT 38,94,99,88,209 
INDIRECT ACCESS 81 
INDIRECT ACCESSING 8 
INDIRECT MACRO INSTRUCTION 95,99 
INDIRECT SPECIFICATION 176 
INDSIZE 82,84,81,207 
INDSKIP 82,84,81,207 
INITIALIZATION 

TIME OF 48-49 
INITIALIZATION PROCESS 48-49 
INITIALIZATION PSB 46 

SPECIAL 45 
INITIALIZES 48-49,165 
INITRL 32-33,35,15,57,203 
INPUT DATA SET 96 
INPUT DFHTCT TYPE 70 
INPUT EVENT REJECTED 163 
INPUT LINE 146 
INPUT PROCESS QUEUE 67,144 
INPUT QUEUE 145,61,146 
INPUT STATUS 73,121,174 
INPUT STEP 140-141 
INPUT TCTLE 139 
INPUT TCTTE 

SPECIAL 145,140 
INPUT TIOA BIT 1-7 126 
INPUT TPROCESS QUEUE 64 
INPUT USER EXIT 149,140 
INPUT/OUTPUT MACROS 97 
INQUIRY MODE 137 
INSEG 38,15,203 

INTEGRATED COMMUNICATIONS ATTACHMENT 59 
INTERCEPT REQUIRED 168 

INTERFACE DUMMY PROGRAM UNDER CICS/OS 17 
INTERV REQUIRED 173 
INTERVAL CONTROL 4,10,116,169 

ENTRY POINT OF 30 

OPTIONAL TIME-OF-DAY FEATURE OF 26,29 
INTERVAL CONTROL ELEMENT 30 
INTERVAL CONTROL PROGRAM 29-30,45 

MACRO INSTRUCTIONS OF THE 20 
INTERVAL CONTROL PROGRAM BEING 30 
INTERVAL CONTROL PROGRAM TCP 51 
INTERVAL CONTROL PROGRAM 6 25 
INTERVENTION 166,173,58 

EXCEPTION OF 166 
INTERVENTION REQUIRED MESSAGE 173 
INTRA 39-40,101,15,94-95,98,176,2 03,20 8 
INTRA MACRO INSTRUCTION 98 
INTRAPARTITION 171,93 

INTRAPARTITION DATA SET DATA DEFINITION 
INTRAPARTITION DATA SETS 7,40 
INTRAPARTITION DESTINATION 93,101 
INVALID COPY REQUEST 171 
INVALID MESSAGE BLOCK 123,172 
INVALID PROGRAM ID 170 
INVALID REQUEST 161 
INVALID TCAM DESTINATION A0 125 
INVALID TERMINAL ADDRESS 162 
INVALID TRANSACTION IDENTIFICATION 77 
INVALID WRITE REQUEST 174 
INVLIST 192 
INVLIST ORDER 193 
IOERROR 137 
IOSIZE 91,83,85,81,207 

LARGEST 85 
IOWORK 83,85,81,207 
IPL 129 
IPL RECORDS 129-130 

PREPARATION OF 130 
ISADD 38,15,203 
ISADSCN 57,62,64,54,79,188,206 
ISAM 82-85,7,81,199,92,207 
ISAM DATA 92 

ISAM DATA SET ORGANIZATIONS 8 
ISAM DATA SETS 84-85,87 
ISAM DATA SETS UNDER CICS/OS 199 
ISAM FILES REQUESTING NEHREC SERVICES 85 
ISAM LOGIC MODULE END DFHFCTBA 93 
ISAM ORGANIZATION 9 

ISAM SEQUENTIAL RECORD RETRIEVAL 19 38 
ISAM VARIABLE-LENGTH RECORDS 38 
ISSUE TERMINAL CONTROL 144 
ISUPD 38,15,203 
IVBR 38,15,203 9 

-J- 

JCL 20,22,10-11 

JCL DURING STAGE II 20 

JOB 19,21,11 

JOB CONTROL 10,20 

JOB CONTROL LANGUAGE 22,10 

JOBCLASS 19,21,14,201 

JOBNAME 19-20,14,201 

JULIAN 156 



KBL 56,58,54,189,206 

KBRDLOCK 35,54,62,67,206 

KCP 20-21,14,17,26,49,51,201,205 

KCP MACRO INSTRUCTION 29 



KEY 88, 199, 82-84, 81, 86-87,, 207-20 8, 9 
KEYBOARD 

SPECIFY COMPONENT POLLING OF THE 65,71 9 
KEYBOARD LOCK FEATURE OPERATIVE 35 
KEYLEN 87,81,83,192,207 
KEYLEN OPERAND 84,87 



3EL 124-126,129,158,67-68,46-47,116,118,66,89 
90,200 
SYMBOLIC 123,121-122 



100 

91 

106 

109 

113 



77 



LABEL DFHDCTBA 
LABEL DFHFCTBA 
LABEL DFHPCTBA 
LABEL DFHPPTBA 
LABEL DFHSNTBA 
LABEL DFHTCTBA MUST 
LABEL DFHTLTBA 115 
LABEL TCTLEECB 125 
LABEL TCTLEIOA 125 
LANG 28,14,16,18,43,202,204 
LAST STATEMENT 46-47,100,106,109,113,115 
LAST TERMINAL ENTRY 72 

LENGTH 81,207-208,83-84,86-87,95-96,62,64,69 
54,88-9 0,94,206,208,8-9,53,56,76,92 
109,121,123,171 
LENGTH DFHFCT TYPE 81,207-208 
LERB 58,60 
LERB PARAMETERS 60 
LEVEL 

TRIGGER 154,98-99,93,153 
LIBRARY MAINTENANCE PROGRAM 19 
LIMIT 

CONSECUTIVE DISPATCH 154 
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